Checkmate
DocumentationGetting started

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.

Warning

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:

MonitorsCheck intervalMonthly storage
300 serversEvery 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:

MethodTrade-offBest for
Snappy (default)Lower CPU usage, moderate compressionMost deployments
ZlibHigher compression ratio, more CPUStorage-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)
Note

If you're monitoring internal services behind a firewall, ensure Checkmate's server can reach those endpoints on the required ports.