Prerequisites

Supported Operating Systems

Debian 10+
Ubuntu 20.04+
Arch Linux (latest)
Fedora 35+
Raspberry Pi OS
Other Linux distributions with kernel 4.15+
Windows 10+ (binaries available in build artifacts)
macOS (client; the agent runs but is primarily targeted at Linux)

See Platform Notes for platform-specific details.

Supported Architectures

amd64 (x86_64)
arm64 (aarch64) - Raspberry Pi 4, AWS Graviton
armhf (ARMv7) - Raspberry Pi 3
riscv64 (experimental)

Software Dependencies

GPU support requires additional libraries (x86_64 and aarch64 only):

Debian/Ubuntu/Raspberry Pi OS:

sudo apt update
sudo apt install libdrm-dev libdrm-amdgpu1

Fedora:

sudo dnf install libdrm-devel libdrm-amdgpu

On ARMv7 (32-bit) and RISC-V, GPU support is not available — build the agent with --no-default-features:

cargo build --release -p socktop_agent --no-default-features

For Cargo Installation

1. Rust Toolchain

A current stable Rust toolchain is required (the crates use the 2024 edition, so Rust 1.85+).

# Install Rust via rustup (recommended)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Verify installation
rustc --version
cargo --version

# Update if needed
rustup update

2. Build Dependencies

Debian/Ubuntu:

sudo apt install build-essential pkg-config libssl-dev libdrm-dev libdrm-amdgpu1