Skip to content

Repository files navigation

PH Warden

CI Docker License: AGPL-3.0

Warden is an open-source, self-hosted uptime monitor that learns what is normal, reduces alert noise, and can be operated directly or through an AI assistant.

It monitors HTTP endpoints, TCP ports, ICMP hosts, and DNS records; publishes status pages; and sends alerts through Slack, webhooks, or email. Adaptive latency baselines, failure confirmation, flapping detection, and incident correlation help distinguish a real problem from a transient spike.

Warden dashboard

Why Warden

  • Quiet by design: sustained failures, cooldowns, flapping detection, and correlation prevent one problem from becoming dozens of alerts.
  • Learns each service: every monitor can build its own latency baseline instead of sharing an arbitrary global threshold.
  • AI-ready and safe: the role-scoped MCP server lets an assistant investigate and manage monitors without exposing destructive operations.
  • Simple to own: run one container with SQLite, or connect PostgreSQL when you need an external database.

Read Why Warden for the product direction and comparison with conventional uptime monitoring.

Quick start

docker run -d -p 9090:9090 \
  -v warden_data:/data \
  ghcr.io/projecthelena/warden:latest

Open http://localhost:9090 and create your admin account.

Production options are covered in the configuration guide. Ready-to-use SQLite and PostgreSQL Compose files live in deploy/.

Documentation

Start with the documentation index, or read the public roadmap.

License

AGPL-3.0 — Project Helena

About

Self-hosted uptime monitoring that learns normal latency, reduces alert noise, and works with AI through a secure MCP server.

Topics

Resources

Contributing

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages