BrewFSBrewFS
BrewFSBrewFS
Get started
Architecture OverviewRead & Write PathChunk LayoutMetadata LayerObject BackendCache · Compaction · GC
Architecture

Metadata Layer

Pluggable transactional metadata: SQLx, Redis, etcd, TiKV.

The metadata layer stores the namespace, directory entries, inode attributes, file sizes, chunk metadata, slice descriptors, and transactional state.

Backends are pluggable so teams can explore latency, consistency, and operational trade-offs:

  • SQLx — SQLite for local development; PostgreSQL / MySQL for shared setups.
  • Redis — lowest-latency metadata operations.
  • etcd — strongly consistent, clustered.
  • TiKV — horizontally scalable transactions.

Agent workloads are metadata-heavy (readdir, stat, lookup, rename, getattr), which is why the metadata-heavy benchmark isolates this path.

Chunk Layout

Chunk, Block, and Slice as first-class concepts.

Object Backend

LocalFS and S3-compatible object storage for file data.