---
title: "Deploy Garage S3 + WebUI"
description: "Self-hosted S3 storage with a web management dashboard"
category: "Storage"
url: https://railway.com/deploy/vast-green-1
---

# Deploy Garage S3 + WebUI

Self-hosted S3 storage with a web management dashboard

**[Deploy Garage S3 + WebUI on Railway](https://railway.com/template/vast-green-1)**

- **Creator:** PROJETOS
- **Category:** Storage
- **Total deploys:** 5

## Template content

### Garage S3 https://garagehq.deuxfleurs.fr/images/garage-logo.svg

- **Source:** matheusac19/railway_garage_template
- **Start command:** `sh /start.sh`
- **Public domain:** Yes

### WebUI https://i.ibb.co/VcjN1mGM/Whats-App-Image-2026-06-15-at-14-46-30-removebg-preview.png

- **Source:** matheusac19/railway_garage_ui_template
- **Public domain:** Yes

## Documentation

# Deploy and Host Garage S3 + WebUI on Railway

Garage S3 + WebUI is a self-hosted, S3-compatible object storage stack. It pairs the lightweight [Garage](https://garagehq.deuxfleurs.fr/) storage server with the `khairul169/garage-webui` dashboard, deploying both as pre-connected services over Railway's private network — giving you working object storage plus a MinIO-style web console with no manual setup.

## About Hosting Garage S3 + WebUI

This template provisions two services in one project. The **Garage S3** service runs the Garage v2.2.0 binary, automatically initializing the cluster layout, creating your first bucket, and provisioning an S3 access key on first boot — all persisted to a Railway volume so data and credentials survive restarts. The **WebUI** service runs the garage-webui dashboard and connects to Garage's Admin API (port 3902) and S3 endpoint (port 3900) over the private network. Both services share an admin token, so cluster health, bucket management, and the object browser work immediately. Auto-generated credentials appear in the Garage service's deploy logs.

## Common Use Cases

- **S3 storage for your apps** — a drop-in endpoint for any app or SDK that speaks S3 (uploads, user files, static assets).
- **Self-hosted MinIO alternative** — lightweight object storage with a visual console for browsing buckets and objects.
- **Backups & archival** — a durable, low-overhead target for database dumps, logs, and file backups via AWS CLI, `s3cmd`, or `rclone`.

## Dependencies for Garage S3 + WebUI Hosting

- A Railway persistent **volume** (mounted at `/data`) for Garage metadata and object data.
- A shared **admin token** (`GARAGE_ADMIN_TOKEN`) used by the WebUI to authenticate against Garage's Admin API.

### Deployment Dependencies

- Garage object storage — https://garagehq.deuxfleurs.fr/
- Garage WebUI (community dashboard) — https://github.com/khairul169/garage-webui

### Implementation Details

Recommended variables for the **WebUI** service (connecting over the private network):

| Variable | Value | Notes |
|---|---|---|
| `API_BASE_URL` | `http://${{ "Garage S3".RAILWAY_PRIVATE_DOMAIN }}:3902` | Garage Admin API |
| `S3_ENDPOINT_URL` | `http://${{ "Garage S3".RAILWAY_PRIVATE_DOMAIN }}:3900` | Garage S3 endpoint |
| `API_ADMIN_KEY` | `${{ "Garage S3".GARAGE_ADMIN_TOKEN }}` | Must match the Garage admin token |
| `AUTH_USER_PASS` | `admin:$2b$12$...` | Optional bcrypt login; leave blank to disable |

Use **path-style** addressing in your S3 client (Railway has no wildcard subdomains): boto3 `Config(s3={'addressing_style': 'path'})`, AWS SDK `forcePathStyle: true`, or s3cmd `--host-bucket=''`.

## Why Deploy Garage S3 + WebUI on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Garage S3 + WebUI on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


## Similar templates

- [Garage S3 Storage](https://railway.com/deploy/garage-s3-storage) — Ultra-light S3 server: fast, open-source, plug-and-play.
- [Redis](https://railway.com/deploy/redis-1) — Self Host Latest Redis with Railway
- [EasyImg](https://railway.com/deploy/easyimg) — Simple self-hostable Nuxt.js personal image hosting system.

Open this page in a browser: https://railway.com/deploy/vast-green-1