Warden
Warden is Project Helena’s uptime monitoring platform. Deploy it, create an admin account, and start monitoring — the whole process takes minutes.
Why Warden
Section titled “Why Warden”- Fast to set up — single binary, no external dependencies, embedded frontend and database
- Easy from the first click — sensible defaults mean most features work out of the box
- Zero-config start — uses SQLite by default, no database setup required
- Production-ready — PostgreSQL support for high-availability deployments
- Self-hosted — your data stays on your infrastructure
What You Get
Section titled “What You Get”Monitoring
Section titled “Monitoring”- HTTP monitoring with configurable intervals (10s minimum), custom methods, headers, body, and accepted status codes
- SSL certificate tracking with automatic alerts at 30, 14, 7, and 1 day before expiry
- Retry logic with up to 5 retries per check
- Latency-based degradation — Warden distinguishes between “down” and “slow”
Groups & Status Pages
Section titled “Groups & Status Pages”- Organize monitors into groups — by client, environment, service type, or however makes sense for you
- Auto-generated status pages — every group gets its own status page automatically
- Public or private access with custom branding (logo, colors, theme)
- RSS feeds for status updates
Incidents & Maintenance
Section titled “Incidents & Maintenance”- Manual incidents with severity levels, timeline updates, and public/private visibility
- Auto-detected outages that can be promoted to tracked incidents with one click
- Maintenance windows that suppress notifications during planned work
Notifications
Section titled “Notifications”- Slack and webhook channels
- Smart alerting — confirmation thresholds, cooldowns, and flap detection reduce noise
- Daily digest mode to batch non-critical events
- Every event type can be toggled on/off independently
Access Control
Section titled “Access Control”- Four roles — Admin, Editor, Viewer, and Status Viewer
- Google SSO with domain restrictions and auto-provisioning
- API keys for programmatic access
- Status Viewer role — give clients or partners access to only their status page
Built-in From Day One
Section titled “Built-in From Day One”Warden was designed to solve the most common gaps in open-source uptime monitoring. These are features that teams consistently ask for — and they all ship out of the box:
- Multi-user with RBAC — unlimited users with four roles. No more sharing a single password with your team.
- Full REST API — manage monitors, incidents, and settings programmatically with role-based API keys. Integrate with your CI/CD pipeline.
- PostgreSQL support — start with SQLite for zero-config setup, switch to PostgreSQL for production with one environment variable.
- Single Sign-On — Google OAuth with domain restrictions and auto-provisioning. One click to sign in.
- Configurable uptime history — show 1 to 365 days of uptime on your status pages. Your stakeholders see the full picture.
- False alert prevention — confirmation thresholds, notification cooldowns, flap detection, and recovery confirmation eliminate noise so you only get alerted when it matters.
How It Works
Section titled “How It Works”Warden runs as a single process that includes everything:
- An HTTP server with the embedded React dashboard
- A monitoring engine with 50 concurrent workers
- A notification service with async delivery
- An embedded SQLite database (or connection to PostgreSQL)
All configuration is done through the dashboard UI. Environment variables handle deployment settings like port and database.
Next Steps
Section titled “Next Steps”- Installation — deploy with Docker in one command
- Quickstart — create your admin account and first monitor