Back to all templates
Garage logo

Garage

Infrastructure512MB+ RAM

Lightweight, geo-distributed S3-compatible object storage server

infrastructurestoragegarageopen-sourceself-hosteddocker

Deploy Garage in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Garage

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Garage on a VPS with Server Compass

Use the Garage template in Server Compass to deploy a single-node S3-compatible object storage service on your VPS, then verify the node status and published endpoints.

About 10 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a Garage app
2
Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for Garage

Use the template picker search to find Garage in the Server Compass template catalog.

Searching for Garage in the Server Compass template picker
4
Step 4

Select the Garage template

Choose the Garage template. Server Compass fills the single-node service, static-site port, S3 API port, admin API port, and persistent metadata/data volumes.

Garage template selected in Server Compass
5
Step 5

Review the Garage settings

Confirm the app name and compose service. In this run, the app was named garage-demo and used host port 4145.

Reviewing Garage project settings and compose service
6
Step 6

Deploy Garage

Review the generated compose settings, confirm the Garage static-site, S3 API, and admin API ports are available, and click Deploy.

Reviewing Garage web port before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Garage image, starts the container, and verifies the stack.

Server Compass deploying the Garage template on the VPS
8
Step 8

Confirm Garage is running

After deployment finishes, return to the Apps tab and confirm the Garage app is marked Running with its published ports available.

Garage template running in the Server Compass Apps tab
9
Step 9

Verify Garage from the container

Use the Garage CLI inside the container to confirm the single-node layout is healthy, then check that the S3 and admin endpoints are listening on the VPS.

Garage service verification output from logs

After Garage Opens

  • Create buckets and keys with the Garage CLI or admin API before connecting applications.
  • Do not expose the admin API publicly without reverse proxy authentication or VPN access.
  • Use TLS before sending S3 credentials over the network.
  • Back up the Garage metadata volume before relying on the node for durable storage.
  • Use a multi-node Garage layout for production durability; this tutorial deploys a single-node service.

Verified Result

Garage returned healthy node status output, and Docker reported the expected published S3/admin/static-site ports.

Garage deployment questions

What does the Garage template deploy?

It deploys Garage in single-node mode with persistent metadata/data volumes and published static-site, S3 API, and admin API ports.

Which port did the tutorial use?

The tutorial used host port 4145 for the static-site endpoint. The template also publishes the S3 API and admin API ports.

Does Garage need setup after deployment?

No browser account setup is required. After deployment, create buckets and access keys with the Garage CLI or admin API, then connect an S3-compatible client.

Should this become a blog post?

No. The deployment guide should live on the Garage template detail page and be linked from the reusable template deployment docs page.

After Deployment

After deploying Garage with Server Compass, complete these steps to finish setup

1

Create a `garage.toml` config in the container's /etc/garage.toml with single-node settings

2

Exec into the container and run `garage layout` to assign the node a zone and capacity

3

Run `garage bucket create my-bucket` and `garage key new --name my-app` to get S3 credentials

4

Test with the AWS CLI: `aws --endpoint-url http://YOUR_SERVER_IP:{{S3_PORT}} s3 ls`

Need help? Check out our documentation for detailed guides.

Garage FAQ

Common questions about self-hosting Garage

How do I deploy Garage with Server Compass?

Simply download Server Compass, connect to your VPS, and select Garage from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for Garage?

Garage requires a minimum of 512MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Garage data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Garage backup and restore procedures.

How do I update Garage to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Garage image will be pulled and deployed with zero downtime.

Is Garage free to self-host?

Garage is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Ready to Self-Host Garage?

Download Server Compass and deploy Garage to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass