Skip to content

ADR-004 — Gatus over Uptime Kuma

Date: 2026-03-19 Status: Accepted

Decision

Replace Uptime Kuma with Gatus for service monitoring.

Why

Uptime Kuma requires manual configuration through its web UI — monitors, notifications, and settings cannot be managed as code. Gatus is entirely config-file driven (config.yaml), making it fully GitOps-compatible.

Trade-offs

Uptime Kuma has a more polished UI and broader community. Gatus's UI is minimal. The trade-off is accepted — operational correctness and reproducibility matter more than UI polish for a homelab monitoring tool.