Docs

Browse releases →

garage

Garage — S3-compatible distributed object storage service

garage

Garage — S3-compatible distributed object storage service

2.3.0 · aarch64-darwin

Cluster identity

The RPC secret is a 32-byte cluster key encoded as 64 hexadecimal characters. Bootstrap peers and public addresses must remain stable across members.

Administration credentials

RPC, administrator, and metrics tokens are opaque references projected through service credentials and *_FILE interfaces, never TOML or process arguments.

State and lifecycle

Garage retains metadata and object data in package state and performs compatible migrations during startup. Configuration changes restart the daemon rather than pretending TOML is reloadable.

OptionTypeDescription
bindAddressstring matching [^[:space:]]+Socket address used for Garage cluster RPC.
bootstrapPeerslist of stringGarage node-ID and RPC-address peers used for cluster discovery.
publicAddressstring matching [^[:space:]]+ or nullExternally reachable cluster RPC address advertised to peers.
secretsubmodule or nullOpaque reference for the shared 32-byte hexadecimal RPC secret.