Checkmate
Checkmate is an open-source, self-hosted monitoring application that tracks server hardware, uptime, response times, and incidents in real time with visualizations and alerts.
Visit bluewave-labs/CheckmateOverview
Checkmate is an open-source, self-hosted uptime and infrastructure monitoring application. It regularly checks whether servers and websites are accessible and performing as expected, then provides real-time alerts and reports on availability, downtime, and response time. The repository includes both the frontend and backend, and an optional Capture agent adds CPU, RAM, disk, and temperature insights from remote servers.
Key Features
- Uptime and response-time checks for servers and websites, with real-time alerts and reports on availability, downtime, and response time.
- Self-hosted application with frontend and backend included in the repository.
- Optional Capture agent for CPU, RAM, disk, and temperature data on remote servers; it runs on Linux, Windows, Mac, Raspberry Pi, or any device that can run Go.
- Used in production to monitor 1,600+ servers on a single deployment, with no reported performance bottlenecks or significant operational issues.
- Horizontal scaling through dedicated worker nodes that share check load via MongoDB, documented for more than 5,000 servers.
- Heartbeat monitors for cron jobs, backups, and scheduled tasks through ping URLs.
Use Cases
- Monitor server and website uptime and response times before users notice outages.
- Track hardware metrics such as CPU, RAM, disk, and temperature with the optional Capture agent.
- Monitor cron jobs, backups, and scheduled tasks using passive heartbeat monitors.
- Run a self-hosted monitoring setup where infrastructure data remains under your control.
Getting Started
- Ensure Docker with Docker Compose is installed; Git is only needed if you want to build the image yourself.
- Download the reference Docker Compose file, generate a JWT secret, and start the services with Docker Compose.
- Open the app on the default port 52345; set CLIENT_HOST if the app is reached at another origin.
- Optionally deploy Capture on servers where you want hardware metrics.
Deployment & Requirements
- Docker with Docker Compose installed.
- MongoDB is required; the reference Compose file starts it, or configure DB_CONNECTION_STRING to use an external MongoDB instance.
- Required configuration includes DB_CONNECTION_STRING, JWT_SECRET, and CLIENT_HOST.
- Docker TLS monitors and Checkmate Connect enrollment require ENCRYPTION_KEY.
- For TLS, place a reverse proxy such as Caddy, Traefik, or nginx in front of port 52345.
Before You Adopt
- License: AGPL-3.0. Review its terms before using, modifying, or distributing the project.
- MongoDB is an external required dependency even when using the all-in-one Checkmate image.
- Checkmate sends a small anonymous telemetry report once per installation per day.
- The Kubernetes Helm chart has not yet migrated to the all-in-one image.
- Capture-backed Docker monitors do not provide restart counts, mounts, published host-port bindings, or container logs.
- The Docker daemon does not enable TLS by default, so remote daemon monitoring requires TLS setup.