---
title: "Deploy Gatus Health Dashboard"
description: "Gatus health dashboard that monitors endpoints, kept behind an auth gateway"
category: "Observability"
url: https://railway.com/deploy/gatus-health-dashboard
---

# Deploy Gatus Health Dashboard

Gatus health dashboard that monitors endpoints, kept behind an auth gateway

**[Deploy Gatus Health Dashboard on Railway](https://railway.com/template/gatus-health-dashboard)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/gatus-health-dashboard/manifest.json

- **Creator:** leodev
- **Category:** Observability
- **Total deploys:** 1

## Template content

### Auth Gateway

- **Image:** caddy:2.11.9-alpine@sha256:0bbb055bda6793c999bde78b1b5ce3e89f829fb031af2cf50056ea1246559fee
- **Start command:** `/bin/sh -ec '[ "${#GATEWAY_PASSWORD}" -ge 16 ] || { echo "GATEWAY_PASSWORD is required (16 or more characters); refusing to start" >&2; exit 64; }; [ "${#GATEWAY_DENIAL_MARKER}" -ge 16 ] || { echo "GATEWAY_DENIAL_MARKER is required (16 or more characters); refusing to start" >&2; exit 64; }; [ -n "${GATEWAY_USER:-}" ] && [ -n "${GATEWAY_UPSTREAM:-}" ] && [ -n "${PORT:-}" ] || { echo "GATEWAY_USER, GATEWAY_UPSTREAM and PORT are required" >&2; exit 64; }; GATEWAY_PASSWORD_HASH="$(printf "%s\n" "$GATEWAY_PASSWORD" | caddy hash-password)"; export GATEWAY_PASSWORD_HASH; unset GATEWAY_PASSWORD; printf "%s\n" "{" "admin off" "auto_https off" "persist_config off" "}" ":{\$PORT} {" "handle /__gateway/health {" "header X-Gateway-Responder health" "respond \"ok\" 200" "}" "handle {" "basic_auth bcrypt autopilot-gateway {" "{\$GATEWAY_USER} {\$GATEWAY_PASSWORD_HASH}" "}" "reverse_proxy {\$GATEWAY_UPSTREAM} {" "header_up -Authorization" "header_down -X-Gateway-Denial" "}" "}" "handle_errors 401 {" "header X-Gateway-Denial {\$GATEWAY_DENIAL_MARKER}" "}" "}" >/tmp/gateway.Caddyfile; exec caddy run --config /tmp/gateway.Caddyfile --adapter caddyfile'`
- **Health check:** /__gateway/health
- **Public domain:** Yes

### gatus

- **Image:** ghcr.io/twin/gatus:v5.38.0@sha256:085ed63da963728965d00a3c78aa6167e3bf135218485b893201758e079e8415
- **Health check:** /health

## Documentation

# Deploy and Host Gatus Health Dashboard on Railway

Gatus is a developer-oriented health dashboard. It checks services over HTTP, TCP, DNS and other protocols and evaluates conditions on status code, response time, body and certificate expiry.

## About Hosting Gatus Health Dashboard

This template runs the official Gatus v5.38.0 image, pinned by digest, on Railway's private network, behind an authenticating gateway that is the only public service. Open the gateway's domain and sign in as `admin` with the generated `GATEWAY_PASSWORD` from the Auth Gateway service's variables; no request reaches Gatus without it. This template runs the configuration bundled in the official image, which monitors sample endpoints and keeps results in memory, so history is lost on restart. To monitor your own services or keep data, supply your own Gatus configuration file, for example through a derived image. Alerting providers you configure may send messages through third-party services.

### Deploy and sign in

1. Deploy the template and wait for the health check to pass.
2. Open the Auth Gateway domain and sign in at the prompt as `admin` with the `GATEWAY_PASSWORD` value from the Auth Gateway service's variables.
3. Open the service URL to see the health dashboard.
4. Supply your own Gatus configuration to choose which endpoints are monitored.

## Why Deploy Gatus Health Dashboard on Railway

It gives you a lightweight dashboard showing uptime, response times and events for your services. It runs as one small container, and a gateway keeps it private.

## Common Use Cases

- Watch the uptime and response time of your own websites and APIs
- Check certificate expiry and response conditions on a schedule
- Keep a private status dashboard for a small team

## Dependencies for Gatus Health Dashboard Hosting

The template uses the official [Gatus](https://github.com/TwiN/gatus) container image.

### Deployment Dependencies

- [Gatus source](https://github.com/TwiN/gatus)
- `ghcr.io/twin/gatus:v5.38.0@sha256:085ed63da963728965d00a3c78aa6167e3bf135218485b893201758e079e8415`
- `caddy:2.11.9-alpine@sha256:0bbb055bda6793c999bde78b1b5ce3e89f829fb031af2cf50056ea1246559fee` (the Auth Gateway service: Caddy with HTTP Basic auth)
- No persistent volume; the service is stateless


## Similar templates

- [Rootprint](https://railway.com/deploy/rootprint-1) — Open-source logs and traces with full-text search on object-storage.
- [Pyroscope profiling](https://railway.com/deploy/pyroscope-profiling) — Protected continuous profiling with durable Pyroscope storage.
- [SigOnly](https://railway.com/deploy/sigonly) — Deploy SigNoz with a working demo app & config in one click

Open this page in a browser: https://railway.com/deploy/gatus-health-dashboard
