BrewFSBrewFS
BrewFSBrewFS
Get started
Quick StartInstallationMount BrewFSConfigurationPerformance tuning parametersCLI Reference
Getting Started

CLI Reference

The brewfs command-line interface.

Commands

brewfs mount [OPTIONS] [MOUNT_POINT]  # mount the filesystem
brewfs info [MOUNT_POINT]             # inspect a running mount
brewfs gc [MOUNT_POINT] [--dry-run]   # run orphan-object GC
brewfs console [OPTIONS]              # run the BrewFS web console

Common mount options

--data-backend  <local-fs|s3>      # object block storage
--data-dir      <path>             # LocalFS data directory
--s3-bucket     <bucket>           # S3-compatible bucket
--s3-endpoint   <url>              # RustFS, MinIO, Ceph RGW, or another S3 endpoint
--meta-backend  <sqlx|redis|etcd|tikv>
--meta-url      <url>              # e.g. sqlite:///tmp/meta.db, redis://…

Runtime metrics are exposed through the read-only .stats file at the mount root. Use cat /mnt/brewfs/.stats for Prometheus text or build brewfs-stats for a live terminal view. Run brewfs --help and brewfs <COMMAND> --help for the current option list.

Performance tuning parameters

Workload-specific cache, S3, FUSE, writeback, and metadata settings.

Architecture Overview

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

On this page

CommandsCommon mount options