# Install garage with Homebrew, apk, MacPorts, pacman, zypper

S3 object store so reliable you can run it outside datacenters. Version 2.3.0 via Homebrew; verified from local package data. Also installable with apk: sudo apk add garage.

## Install

```sh
sudo av install brew:garage
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install garage
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install garage
```

  Evidence: MacPorts ports tree: net/garage/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add garage
```

  Evidence: Alpine Linux edge package indexes: garage from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- pacman (92%):

```sh
sudo pacman -S garage
```

  Evidence: Arch Linux sync databases: garage from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install garage
```

  Evidence: openSUSE Tumbleweed package metadata: garage from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## Package facts

- **Package key:** brew:garage
- **Package manager:** Homebrew
- **Version:** 2.3.0
- **Source summary:** S3 object store so reliable you can run it outside datacenters
- **Homepage:** <https://garagehq.deuxfleurs.fr/>
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- garage (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 2.3.0
## Project history and usage

Garage is a self-hosted, S3-compatible distributed object store from Deuxfleurs, aimed at small-to-medium deployments that span multiple physical locations.

### Project history

The project was created in 2020 by Deuxfleurs, an experimental small-scale self-hosted service provider. Its README describes Garage as the storage service Deuxfleurs has used in production since the first release in 2020.

Garage's design centers on lightweight operation, resilience to machine failures, and replication across locations rather than compatibility with filesystem or POSIX semantics.

### Adoption history

Official documentation presents Deuxfleurs itself as an early production user and invites other organizations to add public use cases. Package-manager availability across Homebrew and several Linux distributions reflects its role as an installable service daemon rather than only a source-built research project.

### How it is used

Users deploy Garage nodes with a TOML configuration file, join them into a cluster, and access storage through S3-compatible clients. The project documents common operations such as binary packages, systemd service setup, gateway nodes, reverse proxying, monitoring, and upgrades.

### Why package nerds care

Garage matters to package and self-hosting communities because it gives S3-compatible object storage a small-operator shape: a single CLI/server package, plain configuration, documented packages, and a design explicitly tuned for machines outside conventional datacenters.

### Timeline

- 2020: Garage project created and first used by Deuxfleurs in production.
- 2021: 0.3.0 release published on the official Deuxfleurs forge.
- 2022: 0.7.0 release published as Garage moved through early public releases.

### Related projects

- Garage is related to Amazon S3 through protocol compatibility, and to Deuxfleurs infrastructure projects such as Bagage, which the official use-case documentation describes as a WebDAV-to-S3 and SFTP-to-S3 proxy.

### Sources

- <https://garagehq.deuxfleurs.fr/documentation/design/goals/>
- <https://garagehq.deuxfleurs.fr/documentation/reference-manual/configuration/>
- <https://git.deuxfleurs.fr/Deuxfleurs/garage>
- <https://git.deuxfleurs.fr/api/v1/repos/Deuxfleurs/garage>
- <https://git.deuxfleurs.fr/api/v1/repos/Deuxfleurs/garage/releases?limit=100>


## Security Notes

formula declares a Homebrew service.

- **Geiger risk:** orange / medium
- formula declares a Homebrew service


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: /etc/garage.toml, $GARAGE_CONFIG_FILE
## Other Package-Manager Records

- apk - garage - 2.3.0-r0: normalized package name match | Alpine Linux edge package indexes: garage from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Lightweight S3-compatible distributed object store | https://garagehq.deuxfleurs.fr
- apk - garage-openrc - 2.3.0-r0: normalized package name match | Alpine Linux edge package indexes: garage-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Lightweight S3-compatible distributed object store (OpenRC init scripts) | https://garagehq.deuxfleurs.fr
- pacman - garage - 2.3.0-1: normalized package name match | Arch Linux sync databases: garage from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A S3-compatible distributed object storage service tailored for self-hosting | https://garagehq.deuxfleurs.fr/
- zypper - garage - 2.3.0-1.4: normalized package name match | openSUSE Tumbleweed package metadata: garage from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | S3-compatible object store for small self-hosted geo-distributed deployments | https://git.deuxfleurs.fr/Deuxfleurs/garage
- MacPorts - garage: normalized package name match | MacPorts ports tree: net/garage/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/garage.yml](https://github.com/mxcl/pkgdb/blob/main/combined/garage.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
