macOS

The recommended way to set up ZebraByte Device Agent on a Mac is:

Install the signed universal .pkg
Enroll the device from the the platform console in your browser

You do not need the command line for a normal install. After the installer finishes, enrollment opens ZebraByte Device Agent.app, which completes the link for you.

CLI enrollment exists only as an advanced fallback for administrators. Prefer the installer and the platform console flow below whenever possible.

Before you begin

Make sure you have:

Access to the the platform console for your region:
- United States: https://www.zebrabyte.ro
- European Union: https://www.zebrabyte.ro
The Mac you want to enroll
Permission to install software (you may be asked for an admin password)

Download the macOS .pkg from the Download page, or from GitHub Releases under the probo-agent/v* tag.

How enrollment works

After the agent is installed, someone with access to the the platform console starts enrollment for your device. In the the platform console, choose your region if prompted, then click enroll. Your browser opens a probo://enroll?... link. Because the installer already registered that link handler, macOS hands it to ZebraByte Device Agent.app, which finishes enrollment without a terminal.

You should see a short confirmation in the tray or in ZebraByte Device Agent.app. The device then appears as enrolled in the the platform console and begins reporting posture checks.

Install the signed package

macOS releases ship a universal signed .pkg that works on both Apple silicon and Intel Macs—for example probo-agent_1.2.3_darwin.pkg. Use this package; do not rely on a manual CLI install for day-to-day enrollment.

Download the package

From the Download page, download the macOS .pkg for the latest ZebraByte Device Agent release.
Run the installer

Open the downloaded .pkg and follow the installer screens. Approve the installation if macOS asks for your password.

The package installs the agent, registers the probo:// URL handler so browser enrollment works, and installs the privileged helper that completes enrollment securely.
Enroll from the the platform console

Open the enroll page for your region: us.the platform.com/enroll or eu.the platform.com/enroll.

Choose your region if prompted, then click enroll.

Your browser opens a probo://enroll?... link. Allow macOS to open it with ZebraByte Device Agent.app if prompted. The app (and tray) completes enrollment for you.
Confirm enrollment

Check ZebraByte Device Agent.app or the menu bar tray for a successful enrollment message. You can also refresh the device page in the the platform console—it should show the device as enrolled and start showing posture results shortly after.

On macOS, browser enrollment must use the signed app deeplink after the .pkg install.

Advanced: CLI enrollment

CLI enrollment is not the recommended path on macOS. Prefer the installer and the platform console enroll steps above. Use the command below only if browser enrollment is unavailable and an administrator asks you to enroll from a terminal.

To get a one-shot enrollment token, open the Employee Portal, go to the Devices tab, and use the Try creating it manually link. Copy the token from there—do not share it, and do not put it in a URL or chat log.

Then run an elevated install with your region’s server URL and that token:

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

Use https://eu.probo.com for EU organizations, or your self-hosted base URL. See Commands for optional flags.

Verify installation

After enrollment (installer path or CLI), you can confirm local state:

probo-agent status

status prints the server URL, device ID, heartbeat/posture/update intervals, and whether auto-update is enabled. In most cases, confirming the device page in the the platform console is enough.

Uninstall

sudo probo-agent uninstall

Uninstall stops the service, unenrolls the device, removes tray auto-start where applicable, and deletes local agent state.