garage

Garage

[ Website and documentation | Binary releases | Git repository | Matrix channel ]

Garage is an S3-compatible distributed object storage service designed for self-hosting at a small-to-medium scale.

Garage is designed for storage clusters composed of nodes running at different physical locations, in order to easily provide a storage service that replicates data at these different locations and stays available even when some servers are unreachable. Garage also focuses on being lightweight, easy to operate, and highly resilient to machine failures.

Garage is built by Deuxfleurs, an experimental small-scale self hosted service provider, which has been using it in production since its first release in 2020.

Learn more on our dedicated documentation pages:

• Goals and use cases
• Features
• Quick start

Garage is entirely free software released under the terms of the AGPLv3.

---

Summary

S3-compatible geo-distributed object store (Rust, CRDT-based, AGPL) built by Deuxfleurs for small self-hosters; weak-consistency replication.

Learnings

• Conditional writes (If-Match/If-None-Match PUT) are architecturally impossible without a consensus rework — maintainer-confirmed (issue #1052, 2025-05). Never use as an Iceberg backend.
• Full comparison: S3 object storage after MinIO.

Gotchas

• metadata_fsync/data_fsync are OFF by default; default LMDB mode can corrupt all data on hard shutdown (safe only with replication ≥ 2); SQLite metadata needs synchronous = FULL.

Hands-on

(research only — see S3 object storage after MinIO)