Skip to main content
Use this path to verify Oriant on one Mac before a managed rollout.

​
Before you begin

  • You need access to your Oriant organization.
  • The target machine must run macOS and have curl, python3, and an administrator account that can approve the install’s sudo steps.
  • Run the command in a terminal on the machine you are connecting.

​
Install the Agent

  1. In Oriant, open Settings → Deployment or choose Add machines → Single machine.
  2. Select Connect a machine.
  3. Copy the generated command and run it on the target machine.
The enrollment code is single-use and expires after 10 minutes. The installer redeems it for an organization-scoped collector token, downloads and verifies the Agent, installs the Agent and its fail-open watchdog, then enables the macOS system proxy only after the Agent has successfully fetched its config.
The installer stamps every report with one identity. Append --email you@company.com to set it explicitly. Without that flag, it uses ORIANT_EMAIL, then git config user.email, then the local $USER value.

​
Confirm it is working

The deployment dialog updates when the machine claims its enrollment code and again after its first report arrives. You can find the enrolled machine in Assets and its attributed activity in Users. To check the local Agent directly:
The response is JSON. status: "ok" means the Agent has fetched config and is healthy. status: "degraded" means it remains running while delivery is retrying. starting and down return HTTP 503 and mean the system proxy is not ready.
The Agent covers applications that use the macOS system proxy. Applications that bypass the system proxy, and non-macOS devices, are outside this rollout.

​
Remove the Agent

Run the installer with --uninstall on the connected machine:
Uninstalling removes the local Agent and proxy configuration. It does not revoke the organization-scoped collector token; revoke that token in Settings → API Keys → Collector Tokens when decommissioning a machine or fleet.
Last modified on July 18, 2026