README
¶
Warden
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.
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
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
dashboard
command
|
|
|
faketarget
command
Command faketarget runs a small local HTTP server that returns deterministic or random failures, so Warden monitors can be pointed at it to exercise the enriched event capture path (status code, latency, error message, response body excerpt, response headers).
|
Command faketarget runs a small local HTTP server that returns deterministic or random failures, so Warden monitors can be pointed at it to exercise the enriched event capture path (status code, latency, error message, response body excerpt, response headers). |
|
mockagent
command
|
|
|
stress_test
command
|
|
|
internal
|
|
|
docs
Package docs Code generated by swaggo/swag.
|
Package docs Code generated by swaggo/swag. |
|
insights
Package insights reads a monitor's own history and names the shapes in it.
|
Package insights reads a monitor's own history and names the shapes in it. |
|
mcp
Package mcp exposes Warden's monitoring data over the Model Context Protocol, so an assistant can answer questions about it without being handed the whole REST API.
|
Package mcp exposes Warden's monitoring data over the Model Context Protocol, so an assistant can answer questions about it without being handed the whole REST API. |