selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

gatus logo

Self-host gatus

v5.38.0

Developer-focused uptime monitor and status page

ReleaseOpen SourceApache-2.0
docker run -p 8080:8080 --name gatus ghcr.io/twin/gatus:stable
Updated2 weeks ago
LanguageGo
Setup difficultyEasy
ThemeDark mode
Stars
12 810
Port
8080 (Web dashboard, API, metrics and badges (configurable via web.port))
Docker
ghcr.io/twin/gatus
Dashboard listing monitored endpoints with their real-time statusEndpoint results with custom monitoring conditions and response times

What is gatus?

Gatus is an Apache-2.0 health dashboard and status page written in Go: you declare endpoints in a YAML file, poll them over HTTP(S), TCP, UDP, ICMP, DNS, gRPC, SSH or TLS, and evaluate assertions on the status code, response body, response time or certificate expiry. When a condition fails it can fire alerts through roughly thirty providers (Slack, Discord, Teams, PagerDuty, Twilio, Telegram, Opsgenie and more), and you can also point it at your own webhook for custom actions. The dashboard doubles as a public status page with endpoint groups, maintenance windows, announcements, SVG uptime and response-time badges, a read-only JSON API and optional Prometheus metrics at /metrics. Self-hosting is a single container (ghcr.io/twin/gatus or twinproduction/gatus on port 8080) with a mounted config.yaml, or the author's Helm chart and Terraform module for Kubernetes; state lives in memory, SQLite or PostgreSQL. Login is optional via HTTP basic auth or OIDC. Note that suites are marked ALPHA and remote instances EXPERIMENTAL in the docs, and the vendor also sells a managed Gatus.io service.

gatus alternatives

All self-hosted alternatives to AWS CloudWatch → All self-hosted alternatives to Prometheus Alertmanager → All self-hosted alternatives to Splunk →

Should you self-host gatus?

gatus scores 78/100 on selfhost.directory (how scoring works) and ranks #1 of 12 in Uptime Monitoring. It has 12 810 GitHub stars, +510 in the last 30 days.

It shipped 7 stable releases in the past year. The latest, v5.38.0, came out on 28 October 2026. New versions land roughly every 6 weeks.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is openobserve (79/100, 23 085 stars). It scores higher overall, so compare the two before you pick. See gatus vs openobserve side by side.

Features

  • Alert notifications
  • Custom alerting provider
  • Custom health check conditions
  • Domain expiration monitoring
  • Endpoint groups
  • Health dashboard / status page
  • Hot configuration reload
  • Maintenance Windows
  • Multi-protocol health checks
  • Prometheus Metrics
  • Push-based external endpoints
  • Read-only REST API
  • Sequential test suitesDocumented as ALPHA.
  • Status page announcements
  • Uptime and response time badges

gatus README

Gatus

test Go Report Card Go version Docker pulls Follow TwiN

Gatus is a developer-oriented health dashboard that gives you the ability to monitor your services using HTTP, ICMP, TCP, and even DNS queries as well as evaluate the result of said queries by using a list of conditions on values like the status code, the response time, the certificate expiration, the body and many others. The icing on top is that each of these health checks can be paired with alerting via Slack, Teams, PagerDuty, Discord, Twilio and many more.

How to install gatus

Install gatus with Docker

Environment variables
GATUS_CONFIG_PATH, GATUS_LOG_LEVEL, GATUS_DELAY_START_SECONDS

To run Gatus locally with Docker:

docker run -p 8080:8080 --name gatus ghcr.io/twin/gatus:stable

With a configuration file mounted:

docker run -p 8080:8080 --mount type=bind,source="$(pwd)"/config.yaml,target=/config/config.yaml --name gatus ghcr.io/twin/gatus:stable

To build the image locally:

docker build . -t ghcr.io/twin/gatus:stable

Docker Hub image twinproduction/gatus is available as an alternative to ghcr.io/twin/gatus.

How to configure gatus

  • GATUS_CONFIG_PATHEnvironment variable pointing to the config file or a directory of YAML files that get merged.
  • GATUS_LOG_LEVELINFOEnvironment variable controlling log verbosity.

    values: DEBUG, INFO, WARN, ERROR, FATAL

  • metricsfalseWhether to expose Prometheus metrics at /metrics.

    values: true|false

  • storage.typememoryWhere endpoint results are persisted.

    values: memory, sqlite, postgres

  • storage.pathPath used to persist data; only for sqlite and postgres types.

gatus releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Can Gatus be exposed on a custom path such as example.org/status?

No; the UI can be served from a fully qualified domain name but does not support path-based routing.

How to change the color thresholds of the response time badge?

Define ui.badge.response-time.thresholds on the endpoint with five values in milliseconds, covering Awesome, Great, Good, Passable and Bad.

How to fix the 431 Request Header Fields Too Large error?

The request headers reaching Gatus are too large (e.g. big cookies); raise web.read-buffer-size above its default of 8192.

How do I sort by group by default?

Set ui.default-sort-by to group. If you previously sorted the dashboard by another field, the default only applies after clearing the browser's local storage.

Why would I use Gatus when I can just use Prometheus' Alertmanager, Cloudwatch or even Splunk?

Metric-based alerting only fires when there is traffic to produce errors, so a failure with no active clients goes unnoticed. Gatus runs your own health checks instead, letting you be alerted before clients are affected.

More in Uptime Monitoring

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…