Installation
Get Rezolus running on your system.
Quick Install
The installer adds the package repository for your distro, installs Rezolus, and enables the agent, exporter, and hindsight services via systemd.
$
curl -fsSL https://install.rezolus.com | bashUse --disable-services to install without auto-starting. Use -y for non-interactive mode.
Supported Distributions
Debian / Ubuntu
Debian 11, 12, 13 · Ubuntu 20.04, 22.04, 24.04
RHEL / Amazon Linux
Rocky Linux 9 · 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 |
# Check status
$
sudo systemctl status rezolus# Restart after config change
$
sudo systemctl restart rezolusBuild from Source
$
git clone https://github.com/iopsystems/rezolus$
cd rezolus$
cargo build --releaseInstall the binary, configs, and service files:
$
sudo cp target/release/rezolus /usr/bin/$
sudo mkdir -p /etc/rezolus$
sudo cp config/*.toml /etc/rezolus/# Install systemd services
$
sudo cp debian/rezolus.rezolus.service /etc/systemd/system/rezolus.service$
sudo cp debian/rezolus.rezolus-exporter.service /etc/systemd/system/rezolus-exporter.service$
sudo cp debian/rezolus.rezolus-hindsight.service /etc/systemd/system/rezolus-hindsight.service$
sudo systemctl daemon-reload$
sudo 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 is limited to basic CPU metrics. eBPF-based samplers (scheduler, block I/O, TCP, syscall) require Linux.
Install
$
curl -fsSL https://install.rezolus.com | bashRun
On macOS, the agent is run manually (no systemd):
$
sudo rezolus /etc/rezolus/agent.toml# Verify
$
curl http://localhost:4241/metrics/json | jq .Build from Source
$
git clone https://github.com/iopsystems/rezolus$
cd rezolus$
cargo build --release$
sudo cp target/release/rezolus /usr/local/bin/