Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Platform Notes

Linux

Fully supported — agent and client, amd64 and arm64. This is the primary platform.

Raspberry Pi

  • 64-bit (Raspberry Pi OS 64-bit, Ubuntu): aarch64-unknown-linux-gnu — full support including the APT packages.
  • 32-bit (ARMv7): armv7-unknown-linux-gnueabihf — supported, but GPU metrics are not available; when building from source, build the agent with --no-default-features.

Kernel tip: update to kernel 6.6 or newer if you can. The agent uses considerably less CPU on newer kernels — on a Pi 4 under continuous polling, roughly 0.8 of a core before 6.6 versus 0.2 after (idle usage is 0 either way).

Windows

  • Client and agent build with stable Rust and the MSVC toolchain (install Visual Studio Build Tools).
  • Prebuilt .exe binaries for both are available in the build artifacts under GitHub Actions.
  • CPU temperature may be unavailable.

macOS

  • The client works well — build or cargo install as on Linux.
  • The agent runs fine for local use and debugging, but it is primarily targeted at Linux; running it as a launchd service is not documented.

RISC-V (experimental)

  • riscv64 builds from source; install your distribution’s protobuf-compiler package first.
  • No GPU support — build the agent with --no-default-features.

Cross-Compiling

To build agent binaries for Raspberry Pi or other ARM devices from a faster machine, see the cross-compilation guide (Linux, macOS, or Windows hosts).