bluewave-labs/Checkmate

What is it?

Key features

• 01Scheduled checks over HTTP, ping, port, DNS, Docker, gRPC, WebSocket and game servers
• 02Incident creation and resolution when monitored services change state
• 03Status pages and scheduled maintenance windows
• 04Notifications via email, webhooks, Slack, Discord, Telegram, PagerDuty and more
• 05Infrastructure metrics such as CPU, memory and disk through the Capture agent

Use cases

• Monitoring the uptime and response time of your company's websites and APIs
• Watching a home lab or Raspberry Pi servers and Docker containers
• Publishing a status page for customers during incidents and maintenance
• Checking SSL certificate expiry on internal HTTPS endpoints

Quick start

1. 1

   Install Docker and Git

2. 2

   Download the reference Docker Compose file

   curl -O https://raw.githubusercontent.com/bluewave-labs/checkmate/master/docker/docker-compose.yaml
3. 3

   Start Checkmate with a generated JWT secret

   JWT_SECRET="$(openssl rand -hex 32)" docker compose up -d
4. 4

   Open http://localhost:52345 in your browser

Things to know

• !MongoDB is required and is not embedded in the application image.
• !Monitoring the local Docker socket or remote Docker daemons needs extra setup such as volume mounts and TLS credentials.
• !Checkmate is licensed under AGPL-3.0, which is a copyleft license with network-use obligations.

Topics

FAQ

What is Checkmate?

Self-hosted uptime and infrastructure monitoring app that checks HTTP, ping, port, DNS, Docker and more, with status pages and incident alerts. Checkmate is an open source, self-hosted monitoring application for tracking whether websites and servers are reachable and how fast they respond. It runs checks on a schedule, stores the results, and creates incidents when a service goes down or recovers, sending notifications through channels such as email, Slack, Discord, Telegram and PagerDuty.

Is Checkmate free to use? What license does it have?

Checkmate is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.

Is Checkmate still maintained?

Actively maintained. The last commit to Checkmate was on Oct 19, 2026.

What can I use Checkmate for?

Monitoring the uptime and response time of your company's websites and APIs Watching a home lab or Raspberry Pi servers and Docker containers Publishing a status page for customers during incidents and maintenance Checking SSL certificate expiry on internal HTTPS endpoints

How do I install Checkmate?

Install Docker and Git Download the reference Docker Compose file: curl -O https://raw.githubusercontent.com/bluewave-labs/checkmate/master/docker/docker-compose.yaml Start Checkmate with a generated JWT secret: JWT_SECRET="$(openssl rand -hex 32)" docker compose up -d Open http://localhost:52345 in your browser

Where can I get Checkmate?

The source code and installation instructions are on GitHub: https://github.com/bluewave-labs/Checkmate