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 available as pre-built binary packages for several operating systems and package managers. This is the easiest way to install Garage for most users.

Package Manager Installation

apk add garage

Distribution-Specific Details

Alpine Linux

Garage is available in Alpine Linux repositories since version 3.17.
1

Install the package

apk add garage
2

Configure Garage

The default configuration file is installed at /etc/garage/garage.toml. Edit this file to configure your Garage instance.
3

Start the service

rc-service garage start
If you don’t specify rpc_secret in the configuration, it will be automatically replaced with a random string on the first start.
The Alpine Linux package is built without the following features:
  • Consul discovery
  • Kubernetes discovery
  • OpenTelemetry exporter
  • K2V API (will be enabled once stable)

Arch Linux

Garage is available in the official Arch Linux repositories under the extra repository.
pacman -S garage

FreeBSD

Garage is available through the FreeBSD package system:
pkg install garage

NixOS

For NixOS users, Garage can be installed using Nix:
nix-shell -p garage
You can also add Garage to your system configuration or use it in a development environment.

conda-forge

Garage is available through conda-forge using the pixi package manager:
pixi global install garage

Verifying Installation

After installation, verify that Garage is correctly installed by checking the version:
garage --version

Next Steps

After installing Garage, you’ll need to:
  1. Create a configuration file (if not automatically created)
  2. Configure your cluster layout
  3. Create storage buckets and access keys
See the Quick Start guide for detailed configuration instructions.

Alternative Installation Methods

If a binary package is not available for your system, you can:

Build docs developers (and LLMs) love