Installing Capture agent

Overview

Capture is a lightweight monitoring agent that collects infrastructure metrics from your servers and sends them to Checkmate. It runs as a small RESTful API exposing hardware metrics.

Supported platforms

Capture runs on Linux, Windows, macOS, Raspberry Pi, and any device capable of running Go applications.

What it monitors

• CPU — temperature, load, frequency, usage
• Memory — utilization and available memory
• Disk — usage, inode usage, read/write bytes, S.M.A.R.T. data
• Network — activity and packet information
• Docker — container statistics

Installation methods

Docker (recommended)

docker run \
  -v /etc/os-release:/etc/os-release:ro \
  -p 59232:59232 \
  -e API_SECRET=REPLACE_WITH_YOUR_SECRET \
  -d ghcr.io/bluewave-labs/capture:latest

Pre-built binaries

1. Download from GitHub Releases
2. Place in /usr/local/bin
3. Make executable:

chmod +x /usr/local/bin/capture

Go install

go install github.com/bluewave-labs/capture/cmd/capture@latest

Build from source

git clone https://github.com/bluewave-labs/capture
cd capture
just build
# or: go build -o dist/capture ./cmd/capture/

Configuration

Capture uses three environment variables:

Starting the agent

API_SECRET=your_secret GIN_MODE=release ./capture

Connecting to Checkmate

1. Navigate to Infrastructure in Checkmate's sidebar
2. Click Add server
3. Enter the server's address and the API secret you configured
4. The server appears automatically once connected

S.M.A.R.T. monitoring

S.M.A.R.T. disk health monitoring requires:

• Capture installed as a binary (not Docker)
• The smartmontools package installed on the host

# Ubuntu/Debian
sudo apt install smartmontools

# RHEL/CentOS
sudo yum install smartmontools

Related articles