Installation
Get Rezolus running on your system.
curl -fsSL https://install.rezolus.com | sudo bashThe installer adds the package repository for your distro, installs Rezolus, and enables the agent, exporter, and hindsight services via systemd. Run as root or with sudo.
Supported Distributions
Debian / Ubuntu
Debian 12, 13 · Ubuntu 22.04, 24.04
Enterprise Linux (Rocky, Alma, RHEL) / Amazon Linux
Rocky Linux, AlmaLinux, RHEL, CentOS Stream and Oracle Linux 9 & 10 · Amazon Linux 2023
Services
The package installs three systemd services:
| Service | Runs as | Description |
|---|---|---|
rezolus | root | Agent — collects metrics via eBPF |
rezolus-exporter | rezolus | Prometheus exporter |
rezolus-hindsight | rezolus | Rolling ring buffer for post-incident analysis |
sudo systemctl status rezolussudo systemctl restart rezolusBuild from Source
git clone https://github.com/iopsystems/rezoluscd rezoluscargo build --releaseInstall the binary, configs, and service files:
sudo cp target/release/rezolus /usr/bin/sudo mkdir -p /etc/rezolussudo cp config/*.toml /etc/rezolus/sudo cp debian/rezolus.rezolus.service /etc/systemd/system/rezolus.servicesudo cp debian/rezolus.rezolus-exporter.service /etc/systemd/system/rezolus-exporter.servicesudo cp debian/rezolus.rezolus-hindsight.service /etc/systemd/system/rezolus-hindsight.servicesudo systemctl daemon-reloadsudo systemctl enable --now rezolusRequirements
- • Linux kernel 5.8+ for eBPF features
- • Root access (agent runs as root for eBPF)
- • Architectures: x86_64 and ARM64
- • Rust toolchain (for building from source only)
Note: macOS support covers CPU and Apple Silicon GPU metrics. eBPF-based samplers (scheduler, block I/O, TCP, syscall) require Linux.
Install
brew install iopsystems/iop/rezolusThe formula lives in the iopsystems/homebrew-iop tap; brew adds it for you on first install.
The install script does the same thing, and falls back to building with Cargo when Homebrew is not present:
curl -fsSL https://install.rezolus.com | bashRun
On macOS, the agent is run manually (no systemd):
sudo rezolus /etc/rezolus/agent.tomlcurl http://localhost:4241/metrics/json | jq .Build from Source
git clone https://github.com/iopsystems/rezoluscd rezoluscargo build --releasesudo cp target/release/rezolus /usr/local/bin/