# Checkmate

Checkmate is an open-source, self-hosted infrastructure monitoring tool for self-hosters that tracks servers, websites, Docker containers, hardware, uptime, response times, and incidents with real-time dashboards and. It is open source and self-hosted, installable on Proxmox.

Canonical page: https://ourlocalhost.com/app/4481/checkmate

## Description

Checkmate is an open-source, self-hosted infrastructure monitoring tool for self-hosters that tracks servers, websites, Docker containers, hardware, uptime, response times, and incidents with real-time dashboards and alerts.

## Platform availability

Available on 2 of 10 platforms: Proxmox, Any server.

## Health score

65/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 4 days ago)
- Popular: 81 (11,061 GitHub stars)
- Easy to install: 35 (2 install platforms, install notes)
- Security check: 5 (4 serious findings, 24 minor, CI, tests)

## Security check

4 serious findings: A private key is committed in the source code; Uses handlebars 4.7.9, which has a known critical vulnerability; Uses handlebars 4.7.9, which has a known critical vulnerability; Uses maplibre-gl 5.19.0, which has a known critical vulnerability.
Automated checks on commit 08e9ad6, 15 Oct 2026. Not an audit.

## Links

- Official website: https://checkmate.so/
- Documentation: https://checkmate.so/docs
- GitHub: https://github.com/bluewave-labs/Checkmate
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=checkmate

## Common questions

### Do I need to run MongoDB separately for Checkmate?

Yes, Checkmate requires MongoDB and the reference Docker Compose file starts a MongoDB service for you. If you use an external MongoDB instance, set DB_CONNECTION_STRING to it.

### Which origin should I tell Checkmate about if I access it by domain or LAN IP?

The reference setup is normally reached on port 52345 from the local machine. If the app is accessed from another domain or LAN IP, set CLIENT_HOST to that origin.

### How can Checkmate monitor remote server hardware like CPU, RAM, disk, and temperature?

Run the optional Capture agent on the remote server to collect those hardware metrics. Capture is not required for Checkmate, but it adds the extra insight.

### Why might Checkmate not see Docker containers on the same host?

Checkmate needs the correct Docker host setting so it can reach the local Docker socket. If that setting points to the wrong location, it may not be able to monitor containers.

### How do I make Checkmate trust internal or self-signed services?

Place your custom CA certificate in docker/dev/certs/custom-ca.pem and start Checkmate with the custom CA override. Without this, some internal or self-signed monitored services may fail trust checks.

### From which directory should I start Checkmate with Docker Compose?

Start Checkmate from the docker/dev folder with docker compose up -d. Starting it from the wrong folder can prevent Checkmate from finding its configuration files.

---
Source: Our Local Host (https://ourlocalhost.com/app/4481/checkmate), the self-hosted and open-source app directory.
