Install Pierrr Agent

The agent is a static cross-arch binary (Linux x86_64 + ARM64); the installer wraps it in a systemd unit.

Last updated: September 5, 2026

Prerequisites

A Linux server (Ubuntu 22.04+, Debian 11+, Rocky/Alma 8+, openSUSE Leap 15+).
Root or passwordless sudo access.
Outbound HTTPS (443) to your Pierrr hub URL.

Install

Set the licence key as an environment variable and run the one-liner - it's idempotent, so re-running just upgrades to the latest agent build.

bash

curl -sSL https://install.pierrr.com/agent \
  | bash -s -- --license $PIERRR_AGENT_LICENSE

Verify

Confirm the systemd unit is running and watch the journal until you see a successful heartbeat.

bash

sudo systemctl status pierrr-agent
sudo journalctl -u pierrr-agent -f

Next steps

Open your Pierrr dashboard, under Settings then Servers. The new agent should appear within ~30 seconds. From there, head to Apps to deploy your first workload.