Host agent

Download the Pingmon agent

The agent makes one outbound HTTPS connection and needs no inbound firewall rule. It enrols with a token you create in Pingmon, so nothing here is secret — the token is what grants access, and it is issued separately.

Builds

Linux (x86-64)

Statically linked. Runs on any Linux with kernel 3.2 or newer — no glibc requirement, so it works on older distributions as well as current ones.

SHA-256 577415e288b0a35f292f4afdb43cf3f52b74ee7789da011e99998191d2f5df44

Download

1.8 MB

Linux (ARM64)

Statically linked, for ARM servers and single-board computers such as the Raspberry Pi 4 and 5 running a 64-bit OS.

SHA-256 c07c7ba08bcd6b41ed0e8f0853f21f97e7b4a487eb871092d41b8141048d0770

Download

1.5 MB

FreeBSD

Not yet published. The collector is written but has not been built or tested on FreeBSD — build it from source and please tell us how it goes.

build from source

Windows

Not yet published. The collector is written but unbuilt, and the agent does not yet implement the Windows service protocol — it runs under a service wrapper such as WinSW or NSSM.

build from source

Haiku

Not yet published. Haiku is a tier-3 Rust target with no prebuilt standard library, so it is built on Haiku itself. Use the native-tls feature.

build from source

All checksums: SHA256SUMS. Verify a download before installing it:

sha256sum -c SHA256SUMS --ignore-missing

Installing

Create an enrolment token in Pingmon under Agents, then on each host:

sudo install -m 0755 pingmon-agent-0.1.0-linux-x86_64 /usr/local/bin/pingmon-agent
sudo pingmon-agent enroll \
    --server https://your-org.pingmon.tech \
    --token <your-enrolment-token>

Then install the service unit for your platform and start it. One enrolment token can admit many hosts, so it is safe to put the command above in a deployment script or a machine image — each host receives its own separate credential when it enrols.

Linux (systemd)

sudo cp pingmon-agent.service /etc/systemd/system/
sudo systemctl enable --now pingmon-agent

FreeBSD

sudo install -m 0555 pingmon-agent.rc /usr/local/etc/rc.d/pingmon_agent
sudo sysrc pingmon_agent_enable=YES
sudo service pingmon_agent start

Windows

The agent is a console application and does not yet implement the Windows service protocol, so register it under a service wrapper such as WinSW or NSSM rather than with sc.exe directly. The supplied PowerShell installer does both steps.

Haiku

cp pingmon-agent /boot/system/non-packaged/bin/
cp pingmon-agent.launch /boot/system/settings/launch/pingmon-agent
launch_roster start pingmon-agent

Building from source

The agent is a single Rust crate with no build step beyond Cargo. Service units for every platform are in packaging/.

cargo build --release

For a portable Linux binary, build against musl so the result does not depend on the build machine's C library:

rustup target add x86_64-unknown-linux-musl
cargo build --release --target x86_64-unknown-linux-musl

On Haiku, build on the machine itself and select the system TLS backend — the default one has no support for that platform:

pkgman install rust_bin
cargo build --release --no-default-features --features tls-native

What it collects

CPU usage and core count; load averages
Memory and swap, used and available
Disk usage per filesystem, skipping pseudo-filesystems that would always read full
Network throughput per interface, skipping loopback and virtual interfaces
Uptime and process count

Readings appear on the device page alongside everything else Pingmon knows about that host, and are kept for as long as your plan's retention allows.

Back to features