Skip to main content
This guide walks you through installing the Origin agent on a macOS endpoint, from running the installer to confirming the agent is reporting in. The whole flow takes about five minutes and requires:
  • A macOS host you can sign in to as an admin.
  • The Origin agent .pkg installer for your tenant.
  • The JWT provisioning token from your Origin dashboard.
Where to get the installer and tokenBoth live in the Origin dashboard under Endpoints → Connect. Download the latest .pkg and copy the JWT to your clipboard before you start.

​
Step 1 — Launch the installer

Double-click the .pkg you downloaded. macOS opens the standard Installer app. Installer welcome screen Click Continue.

​
Step 2 — Confirm the install location

The installer shows the disk it will install to (typically Macintosh HD) and the disk-space footprint (~89 MB). Standard install on Macintosh HD Click Install.

​
Step 3 — Authenticate to install

macOS prompts for your admin password to allow the installer to write to system locations. Installer password prompt Enter your password and click Install Software.

​
Step 4 — Paste the registration token

After the package extracts, the Origin Agent Registration dialog appears. Paste the JWT provisioning token you copied from the dashboard. Origin Agent Registration prompt Click Register.

​
Step 5 — Allow the installer to control System Events

The installer needs to drive System Events to finish wiring the agent into the OS so it launches and stays running at login. Installer wants access to control System Events Click Allow.

​
Step 6 — Grant Full Disk Access

The agent prompts you to grant Full Disk Access so it can read application logs and detect AI tooling installed in user-scoped locations. Full Disk Access required dialog Click OK. macOS opens System Settings → Privacy & Security → Full Disk Access.
  1. Click the + button at the bottom of the list.
  2. Navigate to /Applications and select Origin.app.
  3. Click Open, then toggle the row on.
Full Disk Access — Origin enabled The agent will start automatically as soon as the toggle flips on.

​
Step 7 — Confirm background activity

macOS posts a notification confirming the agent is allowed to run in the background at login and startup. App background activity confirmation You’re done. The agent is now reporting in. Check the Origin dashboard — the host should appear in the Endpoint Explorer within a minute.

​
Verify the install

Open the menu bar Origin icon — a green dot means the agent is healthy. You can also run the built-in health check from there. If the host doesn’t appear in the dashboard within a couple of minutes, see Log Locations below for the install and runtime logs. For a full end-to-end verification workflow, see Verifying Agent Installations.

​
Log Locations

The macOS Origin install creates a menu bar icon. This provides visibility into the overall health of the agent, allows you to run a health diagnostic report, and provides quick access to agent logging.