Onboarding

Onboard a Mac

Install the Enlist agent on a Mac with one Terminal command or your MDM, grant Full Disk Access, and turn on Find My.

Macs onboard with one Terminal command, or with the Enlist package pushed from your MDM. The agent is one package for Apple silicon and Intel Macs on macOS 14 or later.

Macs the client buys through Apple or a reseller can set themselves up with no command at all: see Mac zero-touch with Apple Business Manager.

Install with Terminal #

  1. In Devices → Add devices, choose the client and pick Get install commands.

  2. Copy the Mac (Terminal) command. It looks like curl -fsSL https://…/install.sh | sudo bash -s -- '<token>'.

  3. On the Mac, open Terminal, paste the command, and type the Mac's admin password when asked.

The agent installs, connects to Enlist, and starts the client's blueprint.

Install with your MDM #

If your Macs are in an MDM, push the Full Disk Access profile first (below), then run the same Mac (Terminal) command through your MDM's scripts feature, which runs it as root. The agent can then do everything from the moment it starts, with nobody at the Mac.

Full Disk Access #

The agent needs Full Disk Access to read and change everything a blueprint asks for.

  • With an MDM: push the Enlist PPPC profile (Enlist-PPPC_v<version>.mobileconfig, made with each Mac agent release; email [email protected] for the current one) before installing the agent. Nobody has to click anything. macOS accepts this kind of profile only from an MDM: installing it by hand does nothing.
  • By hand: an admin opens System Settings → Privacy & Security → Full Disk Access, picks +, and adds /Library/Application Support/Enlist/bin/enlist-agent (press ⌘⇧G to type the path).

Until it's granted, the agent reminds the signed-in person at most once a day, with an Open Settings button. The device's page shows Full Disk Access as granted by MDM profile, granted, or missing.

Find My #

macOS doesn't let any tool sign in to an Apple Account silently. If the blueprint has the check Find My is on for an admin account, the onboarding stops and tells the technician to sign in as that admin account and turn on Find My. Then pick Resume. Enlist checks it worked, and later alerts you if Find My changes (security.find_my_changed).

FileVault #

A Turn on disk encryption step turns on FileVault and stores the recovery key in Enlist before the Mac can be ready. See Admin passwords and recovery keys.

Remove the agent #

sudo "/Library/Application Support/Enlist/bin/enlist-agent" uninstall

Last updated 2026-11-14. Something wrong or missing? Email [email protected].