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

Read & Write Path

The IO path as a clear Rust pipeline — no hidden magic.

BrewFS exposes the IO path as a clear Rust pipeline — no hidden magic between a file write and an object block.

Write path

FUSE write
  → VFS::write
  → FileWriter::write_at
  → Chunk split
  → SliceState append
  → Auto flush
  → DataUploader
  → ObjectBlockStore
  → Metadata commit

Read path

FUSE read
  → VFS::read
  → FileReader
  → Load Slice metadata
  → Map offset → object blocks
  → Read object backend
  → Merge slices / zero-fill holes
  → Return bytes

Architecture Overview

Six clear layers from FUSE to object storage — not a black box.

Chunk Layout

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

On this page

Write pathRead path