Openstatus README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Openstatus listing page.
openstatus
The open-source status page and uptime monitoring platform.
Learn more »
Documentation
·
Website
·
Discord
About openstatus
openstatus is the open-source uptime monitoring and status page platform built for infra as code. Declare monitors and status pages in code. Let your agents update them.
Monitors, status pages, and notification channels are declared in YAML or Terraform, applied from the CLI or CI, and operable from Claude, ChatGPT, or Cursor over MCP. Available as a managed service or self-hosted.
Why openstatus?
- Infra as code — monitors, status pages, and notifications in YAML or Terraform, applied from the CLI or CI
- Built for humans and agents — MCP server,
--jsonCLI, typed API, read-only or read-write key scopes, every mutation in the audit log - Status pages + monitoring in one tool — no need to wire up a separate monitoring service
- 28 global regions checking in parallel across 3 cloud providers
- Flat pricing, unlimited members — no per-seat or per-subscriber charges
- Open source & self-hostable — AGPL-3.0, private-locations run in a single 8.5MB Docker image
- Incident communication — subscriber notifications via email, RSS, and webhooks
Status pages
Beautiful, customizable status pages with custom domains, password protection, maintenance windows, and subscriber notifications via email and RSS. Build trust and keep your users informed during incidents.
Uptime Monitoring
Monitor your servers, websites and APIs from 28 regions across multiple cloud providers globally. Get notified via Slack, Discord, PagerDuty, email, and more when your services are down or slow.
Recognitions
Tooling
Everything the dashboard does is reachable from your terminal, your infrastructure code, and your AI assistant — all sharing a single API key.
- API — typed JSON-over-HTTP (ConnectRPC) with a Node SDK
- CLI — interactive for humans,
--jsonfor agents, YAML monitoring as code - Terraform — monitors, notifications, and status pages as HCL
- MCP server — connect Claude, ChatGPT, Cursor, or any MCP client to your workspace
Getting Started
With Docker (Recommended)
The fastest way to get started for both development and self-hosting:
Full guide: DOCKER.md
Self-Hosting with Coolify
We provide pre-built Docker images for easy deployment:
Complete Coolify Deployment Guide
Self-Hosting with Railway
Deploy the full stack (dashboard, status pages, API, workflows, probes, libSQL, and Tinybird Local) to one Railway project with one click:
The template source and the setup instructions are in ephraimduncan/openstatus-railway.
Manual Setup
Requirements
Dashboard
See apps/dashboard/README.md for full steps (env, db, login, troubleshooting).
Status page
- Install dependencies
pnpm install
- Run the server
pnpm -w dev:status-page.
Web (marketing site)
- Install dependencies
pnpm install
- Run the server
pnpm -w dev:web.
Tech Stack
- Next.js - Dashboard
- Hono - API server
- Go - Checker
- Turso - Database
- Drizzle - ORM
- Tinybird - Analytics
- Tailwind CSS - Styling
- shadcn/ui - UI components
Contributing
If you want to help us build the best status page and monitoring platform, check our contributing guidelines.
Contact
Interested in our enterprise plan or need special features? Email us at ping@openstatus.dev or book a call.
License
Distributed under the AGPL-3.0 License.