Device Agent Commands

probo-agent is the CLI for installing, running, inspecting, and updating the device posture agent.

Global flag:

Flag	Description
-d, --dir	Agent config / keystore directory (defaults to the platform-specific path)

install

Enroll this device and install the agent as a managed OS service.

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

Flag	Description
--server	Probo server base URL (required)
--enrollment-token	One-shot enrollment token (or PROBO_ENROLLMENT_TOKEN)
--skip-service	Register the device but skip OS service installation
--no-auto-update	Persist updates_disabled in config and skip automatic upgrades

On success the command prints the configured device ID plus heartbeat and posture intervals.

uninstall

Stop the service, unenroll the device from Probo, remove tray auto-start when present, and delete local state.

sudo probo-agent uninstall

On macOS, uninstall requires root (sudo).

run

Run the agent loop in the foreground. Useful for debugging; production installs normally run under the OS service supervisor.

probo-agent run

status

Print the agent’s local state.

probo-agent status

Example fields:

• Server URL
• Device ID
• Heartbeat interval
• Posture interval
• Update interval
• Auto-update enabled
• Whether an API key is present on disk
• Config directory

collect

Run the posture check set once and print results without pushing them to the server.

probo-agent collect
probo-agent collect --json

Flag	Description
--json	Emit JSON instead of the table
--print-dir	Print the resolved agent directory before results
--once	Run once and exit (default true)

update

Check GitHub Releases for a newer probo-agent/v* tag and install it in place. Releases are verified with Cosign/Sigstore before the binary is replaced.

probo-agent update
probo-agent update --check

Flag	Description
--check	Report whether an update is available without installing it

After a successful update, restart the OS service (or let the supervisor restart after the agent exits with the dedicated restart code).

Enrollment paths

• macOS: install the signed .pkg, then enroll from the Probo console via Probo Agent.app / probo:// deeplink. See macOS.
• Windows: install the signed .msi, then enroll from the Probo console via the tray. See Windows.
• Linux: enroll with install.sh or probo-agent install. See Linux.
• FreeBSD: enroll with install.sh or probo-agent install. See FreeBSD.