Where Does Garage Store Config and Data?
Garage reads garage.toml with metadata in the data directory it names, usually under /var/lib/garage.
Last updated
Garage splits settings from stored objects cleanly. The garage.toml file sets node identity, ports, and data paths for the deployment. Metadata and objects persist under the data directory it names.
Cluster layout tokens generate on first join and persist with the data. Losing the data dir orphans the node from the ring. Back up the TOML with data snapshots per node for restores.
Where Garage stores this, by platform
/etc/garage.toml
Node identity, ports, and data paths live here. Data defaults under /var/lib/garage per config. Layout tokens persist with the data.
Frequently asked questions
How do I back up Garage?
Copy garage.toml with a snapshot of the data directory per node. Layout tokens inside tie nodes to the ring. Restore matching versions together.
Where are Garage objects?
Under the data directory named in garage.toml, split across nodes by the ring. No single node holds everything. The TOML maps paths to roles.
Notice an outdated path? Let us know.