BrewFSBrewFS
BrewFSBrewFS
Get started
OperationsObservabilityControl PlaneGC CommandTestingPOSIX TestingKubernetes Operator
Operations

Control Plane

Operational commands against a live mount.

The control plane exposes operational commands against a live mount:

brewfs info /mnt/brewfs            # inspect the selected running instance
brewfs gc /mnt/brewfs --dry-run    # submit and follow an orphan-GC job

Each mount registers its PID, mount point, Unix socket, and start time in the local runtime registry. info and gc locate that record and send a request to the instance-scoped Unix socket. If exactly one instance is running, the mount point can be omitted; specify it when multiple mounts are active.

The protocol currently supports Ping, GetInfo, RunGc, and GetJob. GC is an asynchronous job: the CLI submits it, receives a job ID, and follows it until completion. The control plane is local-only and does not expose a network listener.

Observability

Stats, tracing, logging, and profiling.

GC Command

Removing object data that is no longer referenced.