Agent Setup

The InfraPilot agent runs on each server you connect. It runs as a Docker container and talks to the dashboard over a secure gRPC connection (mutual TLS). Copy the exact command from Settings → Agents → Add Agent, which fills in your hub URL, enrollment token, and registry credentials.

Installing the agent (Docker)

# Run on the server you want to connect (Docker required)

curl -fsSL https://infrapilot.org/agent-install.sh | bash -s -- \

--hub https://infra.example.com \

--token YOUR_ENROLLMENT_TOKEN

For low-end / IoT / Docker-less nodes, an experimental native build is available at https://infrapilot.org/ip-agent-rust.sh.

Getting your agent token

In the dashboard, go to Settings → Agents → Add Agent. A unique token will be generated for each server you connect. Tokens are tied to your license and count toward your agent limit.

Agent tokens grant monitoring access to your server. Keep them secret and rotate immediately if compromised via Settings → Agents.

Still need help?

Open an issue on GitHub or reach out to our support team.