Troubleshooting Pierrr Agent

Agent stays "offline" in the dashboard

Check the journal: journalctl -u pierrr-agent -f. The most common cause is an outbound firewall blocking 443 - make sure the agent can reach your hub URL.

Heartbeats but no apps deploy

The agent needs Docker (or Podman with Docker-compat). Run docker info as the pierrr-agent user; if it fails, add the user to the docker group and restart the unit.

Licence key invalid

Re-fetch your licence from the dashboard (Settings, Billing, Pierrr Agent licences). The key is rotated when you change plan.

Disk fills up over time

Old container images aren't pruned automatically by default. Enable auto-prune in the agent config (prune.enabled: true) or run docker system prune -af --volumes weekly via cron.