Server install (Linux / FreeBSD)

Install and enroll Probo Agent on Linux or FreeBSD from the command line. This path is for servers and other headless hosts where there is no tray or browser enrollment.

For macOS or Windows desktops (installer + Probo console enroll via the tray), see Desktop install.

Download the latest release from the Download page or from GitHub Releases under the probo-agent/v* tag.

Before you begin

You need:

• A Probo organization with permission to manage devices
• A one-shot enrollment token for the device
• The Probo server URL for your region:
  • United States: https://us.probo.com
  • European Union: https://eu.probo.com
  • Self-hosted: your instance base URL (no path)
• Root or sudo on the host

Install with install.sh

Each release includes an install.sh that downloads the matching archive, verifies its checksum, installs to /usr/local/bin, and enrolls the device.

Interactive:

curl -fsSL "https://github.com/getprobo/probo/releases/download/probo-agent/vX.Y.Z/install.sh" | sudo sh

Unattended / MDM:

curl -fsSL "https://github.com/getprobo/probo/releases/download/probo-agent/vX.Y.Z/install.sh" | sudo \
  PROBO_SERVER_URL=https://us.probo.com \
  PROBO_ENROLLMENT_TOKEN='YOUR_TOKEN' sh

Or pass flags:

curl -fsSL "https://github.com/getprobo/probo/releases/download/probo-agent/vX.Y.Z/install.sh" | sudo sh -s -- \
  --server https://us.probo.com \
  --enrollment-token 'YOUR_TOKEN'

Replace vX.Y.Z with the release version from the Download page.

Useful environment variables

Variable	Description
PROBO_SERVER_URL	Probo server base URL
PROBO_ENROLLMENT_TOKEN	One-shot enrollment token
PROBO_NO_AUTO_UPDATE	Set to true to disable automatic upgrades
PROBO_AGENT_STATE_DIR	Override the agent state directory (default /var/lib/probo-agent)

Never put the enrollment token in the curl URL.

Manual CLI install

If you already have the binary on disk:

sudo probo-agent install \
  --server https://us.probo.com \
  --enrollment-token YOUR_TOKEN

Useful flags:

Flag	Description
--server	Probo server base URL (required)
--enrollment-token	One-shot enrollment token (or PROBO_ENROLLMENT_TOKEN)
--skip-service	Register the device but do not install the OS service
--no-auto-update	Disable automatic upgrades
-d, --dir	Override the agent config/keystore directory

The agent runs as a managed OS service (systemd on Linux, rc.d on FreeBSD). Default state directory: /var/lib/probo-agent.

Verify installation

probo-agent status
probo-agent collect

status prints the server URL, device ID, heartbeat/posture/update intervals, and whether auto-update is enabled. collect runs the posture checks once locally.

Uninstall

probo-agent uninstall

Uninstall stops the service, unenrolls the device, and deletes local agent state.

Next steps

Commands Full command reference for install, status, collect, update, and uninstall

Desktop install Install on macOS or Windows and enroll from the Probo console