Garage S3 Storage
matheusac19
PROOP

2 months ago

Description: Ultra-light S3 server: fast, open-source, plug-and-play 🚀

Category: Storage

URL: https://railway.com/deploy/garage-s3-storage

7 Replies

jesushdez
HOBBY

2 days ago

The health-check is failing (after the 20 attempts in 5 min)

Screenshot 2026-06-14 211502.png

Possible solution: remove the: healthcheckPath = "/?health" in railway.toml

Attachments


matheusac19
PROOP

a day ago

Thanks for the report!

I investigated the issue and confirmed that the failing health checks were caused by the healthcheckPath = "/?health" entry in railway.toml. Since Garage doesn't provide that endpoint, Railway marked the deployment as unhealthy after repeated failed checks.

I've removed the health check configuration from the template and verified that deployments now complete successfully. The service initializes correctly, creates the bucket, imports the access key, and accepts S3 API requests without issues.

Appreciate the feedback!


jesushdez
HOBBY

a day ago

Just out of curiosity (since I'm not an expert on Garage), does Garage have a website/console where you can view the files online, similar to the Minio console?

Something like this:

image.png

Attachments


matheusac19
PROOP

a day ago

Good question! Garage itself doesn't ship with a built-in web console the way MinIO does, and that's intentional. Garage is built to stay as lightweight as possible, so its native administration runs through the CLI and the Admin API rather than a bundled UI.

That said, there's a solid community-built web UI that does exactly what you're after: khairul169/garage-webui (https://github.com/khairul169/garage-webui). It includes an object browser / file explorer to navigate buckets and objects visually, plus access-key and bucket management. It runs as a small standalone binary or Docker container and just points at Garage's Admin API (port 3903) and S3 endpoint (port 3900), so you can run it right alongside this deployment.

There's also an official Garage Admin UI in the works (NLnet-funded), but it's more focused on cluster administration (node, bucket and key management) than on browsing object contents. So for a MinIO-console-style file view, the community web UI above is your best bet today.


jesushdez
HOBBY

a day ago

I tried to configure khairul169/garage-webui but failed miserably. My question was to find out if you could add a web UI to the template or create a new one that contains both (garage and the web UI).


jesushdez

I tried to configure khairul169/garage-webui but failed miserably. My question was to find out if you could add a web UI to the template or create a new one that contains both (garage and the web UI).

matheusac19
PROOP

7 hours ago

Hey! No worries getting the WebUI wired up to Garage manually is genuinely fiddly (private networking, the admin token, matching the admin/S3 endpoints, etc.), so I went ahead and built exactly what you asked for.

I put together a new template that deploys both services together, pre-connected: Garage S3 + the khairul169/garage-webui dashboard. The two services talk to each other over Railway's private network out of the box, so you get the MinIO-style object browser, bucket management, and access-key management without having to configure any of the plumbing yourself.

👉 https://railway.com/deploy/vast-green-1

A small heads-up: Railway auto-generates the template slug, so it unfortunately shows up as "vast-green" instead of the proper "Garage S3 + WebUI" name I'm working on getting that renamed, but the link above is the right one.

After deploying, the only thing you'll want to set is the admin token (shared between both services) and, optionally, a login for the dashboard.

To protect the dashboard with a login: set AUTH_USER_PASS on the WebUI service in the format username:bcrypt_hash (e.g. admin:$2b$12$...) you can generate the hash at Bcrypt Generator or just leave it blank to skip the login entirely.

Let me know if you hit any snags and I'll help you get it running.


jesushdez
HOBBY

3 hours ago

Perfect, thank you. I'll try it later and leave you notes if I find anything.


Welcome!

Sign in to your Railway account to join the conversation.

Loading...