Server requirements
Hardware, storage and data retention requirements for running Checkmate.
Overview
Checkmate is designed to run on modest hardware. A single-node deployment can comfortably monitor a few hundred targets at short intervals.
Hardware requirements
Checkmate runs comfortably on:
- Raspberry Pi 5: suitable for small deployments, on a 64-bit OS
- Any Linux VPS with 1+ GB RAM
- macOS or Windows machines for development
For a production deployment monitoring 300+ servers every minute, the Node.js instance uses minimal memory. MongoDB on the same server uses approximately 400 MB.
A Raspberry Pi 4 is not supported. Checkmate's reference deployment runs mongo:8.0, and MongoDB 5.0 and later require an ARMv8.2-A CPU. The Pi 4's Cortex-A72 is ARMv8.0-A, so the MongoDB container exits with Illegal instruction on startup. The Pi 5's Cortex-A76 is ARMv8.2-A and works.
Storage requirements
Disk usage scales with the number of monitors and check frequency. As a reference:
| Monitors | Check interval | Monthly storage |
|---|---|---|
| 300 servers | Every 1 second | ~3 GB/month |
This translates to roughly 36 GB annually at that scale. Most deployments with less frequent checks will use significantly less storage.
Data retention
Checkmate maintains a default check retention policy of 30 days. You can adjust this under Settings > Monitoring > Check retention to retain data for longer or shorter periods. The maximum is 366 days and the field also accepts an Unlimited option.
Database compression
Checkmate uses MongoDB, which supports two compression methods:
| Method | Trade-off | Best for |
|---|---|---|
| Snappy (default) | Lower CPU usage, moderate compression | Most deployments |
| Zlib | Higher compression ratio, more CPU | Storage-constrained environments |
Snappy is the default and works well for the majority of deployments. Switch to Zlib only if storage is a primary concern and you have CPU headroom.
Network requirements
- Outbound HTTP/HTTPS: for uptime checks to monitored endpoints
- Port 52345 (default), for the Checkmate application
- Port 27017: for MongoDB (internal)
- Port 59232: for Capture agent communication (if using infrastructure monitoring)
If you're monitoring internal services behind a firewall, ensure Checkmate's server can reach those endpoints on the required ports.