Skip to content

v0.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 29 Jun 07:46
v0.1.0
f2ad10b
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

FileDB v0.1.0 — first release 🎉

A lightweight, append-only, file-based document database. Single binary, zero dependencies, human-readable NDJSON storage, served over gRPC and REST.

Highlights

  • Append-only NDJSON storage — every insert/update/delete is a new line; inspect, back up, or migrate with any text editor or Unix tool
  • Background compaction — a goroutine per collection merges and deduplicates sealed segments
  • In-memory id index — O(1) lookup by id, persisted with a checksum for fast restarts
  • Secondary indexes — per-field inverted indexes for O(1) equality lookups, automatically maintained and persisted
  • Configurable durability — none (OS flush), always (fsync per write), or interval (fsync on a timer)
  • Transactions — optimistic multi-operation BeginTx / CommitTx / RollbackTx
  • gRPC + REST — dual API from one binary; CLI prefers the Unix socket when local
  • Optional TLS, YAML config (--config), and Prometheus metrics
  • OpenAPI spec + official client SDKs for 7 languages (Python, JS/TS, PHP, Java, Ruby, Rust, C#/.NET)
  • Web admin UI (React + Vite)

Install

Download a prebuilt archive below, or pull the Docker image:

docker pull ghcr.io/srjn45/filedbv2:v0.1.0
docker run -p 5433:5433 -p 8080:8080 -e FILEDB_API_KEY=dev-key \
  ghcr.io/srjn45/filedbv2:v0.1.0 serve --data /data

Prebuilt binaries are available for linux / darwin / windows × amd64 / arm64. Verify downloads against checksums.txt.

See Getting Started and the client SDKs.

Assets 9
Loading