Skip to content

Suggested searches

    Search all documentation ↑↓ to navigate Enter to open Esc to close

    Linux

    Install and enroll Device Agent on Linux servers from the command line using install.sh or the CLI, and verify or uninstall the deployment.

    Markdown

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

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

    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

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

    Interactive:

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

    Unattended / MDM:

    Terminal window
    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:

    Terminal window
    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.

    VariableDescription
    PROBO_SERVER_URLProbo server base URL
    PROBO_ENROLLMENT_TOKENOne-shot enrollment token
    PROBO_NO_AUTO_UPDATESet to true to disable automatic upgrades
    PROBO_AGENT_STATE_DIROverride the agent state directory (default /var/lib/probo-agent)

    Never put the enrollment token in the curl URL.

    If you already have the binary on disk:

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

    Useful flags:

    FlagDescription
    --serverProbo server base URL (required)
    --enrollment-tokenOne-shot enrollment token (or PROBO_ENROLLMENT_TOKEN)
    --skip-serviceRegister the device but do not install the OS service
    --no-auto-updateDisable automatic upgrades
    -d, --dirOverride the agent config/keystore directory

    The agent runs as a managed systemd service. Default state directory: /var/lib/probo-agent.

    Terminal window
    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.

    Terminal window
    probo-agent uninstall

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