Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/deuxfleurs-org/garage/llms.txt

Use this file to discover all available pages before exploring further.

Garage is a lightweight geo-distributed data store that implements the Amazon S3 object storage protocol. It enables you to store large blobs such as pictures, video, images, documents, and more in a redundant multi-node setting.

​
Design goals

Garage is an opinionated object storage solution focused on the following desirable properties:

Internet enabled

Built for multi-site deployments (datacenters, offices, households) interconnected through regular Internet connections

Self-contained & lightweight

Works everywhere and integrates well in existing environments to target hyperconverged infrastructures

Highly resilient

Resilient to network failures, network latency, disk failures, and sysadmin failures

Simple

Simple to understand, simple to operate, simple to debug

​
Non-goals

The pursuit of some goals can be detrimental to our core objectives. We’ve identified the following as non-goals:
If these points matter to you, Garage may not be the right solution for your needs.
  • Extreme performance: High performance constrains design and infrastructure heavily. We seek performance through minimalism only.
  • Feature extensiveness: We don’t plan to add features beyond those provided by the S3 API.
  • Storage optimizations: Erasure coding and other coding techniques increase the difficulty of data placement and synchronization. We limit ourselves to duplication.
  • POSIX/Filesystem compatibility: We don’t aim for POSIX compatibility or filesystem emulation. In distributed environments, such synchronizations translate to network messages that impose severe deployment constraints.

​
Use cases

Are you using Garage in your organization? Open a PR to add your use case!

​
Deuxfleurs

Deuxfleurs is an experimental non-profit hosting organization that develops Garage. They focus on building highly available infrastructure through redundancy in multiple geographical locations. Their Garage deployment:
  • 9 nodes across 3 physical locations
  • Multi-site cluster configuration
Use cases:
  • Hosting main website and member websites
  • Matrix media backend
  • Nix binary cache
  • Personal data and shared documents storage through Bagage (WebDAV-to-S3 and SFTP-to-S3 proxy)
  • Backup target using rclone and restic

​
Triplebit

Triplebit is a non-profit hosting provider and ISP focused on improving access to privacy-related services. Their Garage deployment:
  • 15 storage nodes across 3 physical locations
  • Multi-site cluster configuration
Use cases:

​
Why Garage?

Garage is designed to fill a specific niche: geo-distributed object storage for small-to-medium scale deployments. If you need:
  • Storage across multiple physical locations
  • Resilience to Internet connectivity issues
  • Simple deployment without complex dependencies
  • S3-compatible API for broad application support
Then Garage is built for you.