Docs / Infrastructure

Pair a machine agent

Step-by-step: add a host with the Linux/Windows pairing install.

infrastructuremachine-agentpairinginstall

Add a host: pair a machine agent (step by step)

The machine agent reports a host's metrics, processes and logs, and can run platform-issued commands. Pairing connects it to your organization.

  1. Go to Infrastructure → Machine agents → Add agent (the pairing dialog opens).
  2. Optionally set a Name and the Environment (e.g. prod).
  3. Copy the install command for your OS — Linux (bash) or Windows (PowerShell) — and run it on the host:
# Linux (example shape — copy the exact command from the dialog, it embeds your pairing token)
curl -fsSL https://app.verops.io/install/machine-agent.sh | \
  sudo VEROPS_PAIRING_TOKEN=<token> VEROPS_ENVIRONMENT=prod bash
  1. Within a few seconds the agent shows ONLINE in the list.
  2. The host now reports metrics and process snapshots; configure log scraping to collect log files (see Machine agent in this category).

Troubleshooting

  • Stays OFFLINE: check outbound HTTPS to app.verops.io and that the pairing token wasn't truncated.
  • No processes shown: the agent may need host PID visibility (run with --pid host in Docker).
You can alert on an agent going OFFLINE — a silent host is often the first sign of trouble.