Skip to main content

macOS Install

Install the Level agent on macOS devices using the one-line command or architecture-specific installer.

Introduction

The Level agent is a lightweight background service that checks in with your account and makes remote control, monitoring, automation, and patch management available for a device. Installing it on macOS takes a couple of minutes, with a few permission grants required after the first install.


⚙️ PREREQUISITES

  • A Level account with permission to add devices

  • Local administrator rights on the target macOS device

  • macOS 11 (Big Sur) or later


🎬 VIDEO


macOS Install

Opening the Install Modal

Click Add new device in the top-right corner of the Device Listing page. In the OS selector, choose macOS.

macOS Install Modal

Selecting a Device Group (Optional)

Select a device group before copying your install command. The install key updates to include the group ID, so the device lands in the right group automatically on first check-in. For the Installer method, this updates the keyed setup command, not the contents of the downloaded PKG.

If you skip this, the device lands in Ungrouped — you can move it afterward.

💡 TIP: Assigning a group at install time means the device immediately picks up all group-level automations and permissions.


The Install Key

Enrolling a Mac uses an install key, a short token visible in the modal that links new devices to your Level account. It's scoped narrowly by design: if exposed, it can't access your account, existing devices, or the Level API. The only risk is that someone could use it to add devices to your account.

If you believe your install key has been compromised, contact Level support to rotate it.

ℹ️ NOTE: The install key reflects your group selection in real time. Without a group selected, it contains just your account identifier. Select a group and the group's ID is appended.


Install Methods

The modal has two tabs for macOS.

One-Line Command

A curl one-liner that downloads and installs the agent. This is the fastest method and works on any supported architecture without selecting one manually.

  1. In the modal, select the One-line command tab.

  2. Optionally select a device group.

  3. Copy the generated command.

  4. On the target device, open Terminal.

  5. Paste and run the command. You may be prompted for your admin password.

One-Line Command Installer

The device shows up in your Device Listing within 5–10 seconds of the install completing.

Installer

Download an architecture-specific PKG, then run the complete command shown in the modal to install and enroll the Mac.

  1. In the modal, select the Installer tab.

  2. Select your architecture from the dropdown: x64 (Intel) or ARM64 (Apple Silicon).

  3. Optionally select a device group.

  4. Click Download installer to download the PKG file.

  5. On the target Mac, open Terminal and change to the folder containing the downloaded PKG.

  6. Copy and run the complete command shown in the modal. Check that the PKG filename in the command matches the file you downloaded. You may be prompted for your admin password.

macOS Installer Download

ℹ️ NOTE: Double-clicking the standard PKG installs the application and CLI, but the wizard doesn't ask for your install key or enroll the Mac. The complete command shown in the modal installs the PKG first, then runs a separate Level registration command with your install key. Run the full command to complete setup, or use the One-line command method above.

🖥️ PLATFORM NOTE:

  • Intel (x64): Select x64 in the architecture dropdown.

  • Apple Silicon (M1/M2/M3): Select ARM64. Level uses a service account on Apple Silicon devices to support patch management — you'll be prompted for admin credentials after the install completes. This is expected behavior.


Force Install (Advanced)

If a previous Level install left behind stale files, use the forceInstall URL parameter to force a clean overwrite.

ℹ️ NOTE: forceInstall=true is a URL parameter intended for support scenarios. Level support may link you directly to a pre-configured modal URL when troubleshooting.

Navigate to:

https://app.level.io/devices?forceInstall=true

This adds LEVEL_FORCE_INSTALL=true to the generated one-line command.

⚠️ WARNING: Force install overwrites any existing Level agent configuration on the device. Only use this when a standard install fails or Level support directs you to.


Post-Install: Permissions

macOS requires explicit permission grants for remote control, screen recording, and file access. After the agent installs, grant Level access in all three locations under System Settings → Privacy & Security:

  • Screen Recording

  • Device Control and Data Access (macOS 27) or Accessibility (earlier versions)

  • Full Disk Access

macOS 27 (Golden Gate): Apple renamed Accessibility to Device Control and Data Access. Open System Settings → Privacy & Security → Device Control and Data Access and turn on Level. On macOS 26 (Tahoe), the setting is still named Accessibility. To check your macOS version, choose Apple menu → About This Mac.

You'll need admin credentials to make these changes.

ℹ️ NOTE: The install modal lists these three permissions as a reminder at the bottom of both install tabs.


MDM Deployment: mobileconfig Profile (Optional)

💡 TIP: If you're deploying to many macOS devices, use the mobileconfig profile described below. It silently grants Accessibility and Full Disk Access via MDM, and allows non-admins to approve the Screen Recording prompt without needing admin credentials.

For environments managed by MDM, you can deploy a PPPC (Privacy Preferences Policy Control) mobileconfig profile to streamline the post-install permission setup.

The profile handles Accessibility and Full Disk Access silently via MDM policy. Screen Recording is a protected privacy permission that Apple doesn't allow MDM to grant silently — instead, the profile allows non-admin users to approve the Screen Recording prompt themselves, without needing admin credentials.

⚠️ WARNING: The mobileconfig file provided by Level is a sample only. Level doesn't provide support for creating, managing, or troubleshooting MDM configurations — behavior varies across MDM vendors. Test in your own environment before deploying broadly.

To deploy:

  1. Download the mobileconfig profile: Download Level - PPPC.mobileconfig

  2. Push via your MDM tool, or deploy via script as part of your install process.

Once deployed, Accessibility and Full Disk Access are granted automatically. End users can approve the Screen Recording prompt without admin credentials.


AV/EDR Exclusions

Some antivirus and EDR tools flag Level as a threat. Add Level to your exclusions before deploying to avoid the install being blocked or the agent being quarantined after install.

For exclusion paths, certificate details, and tool-specific instructions, see AV/EDR False Detections. Level also publishes a breakdown of why EDR tools flag RMM agents at level.io/blog/edrs-distrust-rmms-and-thats-ok.


System Requirements

Requirement

Details

OS

macOS 11 (Big Sur) or later

Architecture

Intel (x64) and Apple Silicon (ARM64)

⚠️ WARNING: macOS High Sierra, Mojave, and Catalina will no longer be supported after May 4, 2026.

Storage Locations

Path

Purpose

/Applications/Level.app/Contents/MacOS/level

Application binary

/usr/local/bin/level

CLI binary

/var/lib/level

Agent data

/Library/LaunchAgents/io.level.srv.plist

Launch agent

/Library/LaunchDaemons/Level.plist

Launch daemon


After Install

After setup and enrollment complete, the device appears in your Device Listing within 5–10 seconds and starts populating hardware inventory within a few minutes.

If the device doesn't appear, or goes offline shortly after install, see Offline Troubleshooting.


FAQ

  • Is the install key the same as an API key? No. The install key (from Add new device) only enrolls devices into your account. API keys (from Settings → API keys) authenticate external tools against Level's API. You can't install the agent with an API key — use the install key from the install modal. See API Keys Settings.

  • What permissions does Level need on macOS, and why? Level requires Screen Recording (for remote control), Device Control and Data Access on macOS 27 or Accessibility on earlier versions (for input automation during remote sessions), and Full Disk Access (for file operations and patch management). Without these, remote control and some management features won't work.

  • Why am I being prompted for admin credentials after the install finishes on my Apple Silicon Mac? Level creates a service account on Apple Silicon devices to support patch management. This prompt is expected — enter admin credentials to complete the setup.

  • Which architecture should I select in the Installer tab? Select x64 for Intel Macs and ARM64 for Apple Silicon (M1/M2/M3). If you're not sure, check Apple menu → About This Mac. The one-line command method handles architecture detection automatically and doesn't require you to choose.

  • What's the difference between the GUI installer and the terminal command? Double-clicking the standard PKG installs the application and CLI without collecting an install key or enrolling the Mac. The complete command in the Installer tab installs that PKG and then runs Level's registration command with your install key. Use the complete generated command, or the One-line command method, to finish setup.

  • Can I suppress the permission prompts when deploying to many Macs? Partially. Deploy the Level PPPC mobileconfig profile via MDM — it silently grants Accessibility and Full Disk Access. Screen Recording is a protected Apple privacy permission that MDM can't grant silently, but the profile allows non-admin users to approve that prompt themselves without needing admin credentials.

  • Can I send end users an email link to install the agent themselves? No. The agent requires local administrator rights, which most end users don't have. Installation needs to be performed by someone with local admin access, manually or via a deployment tool.

  • What if my install key is compromised? The install key can't access your account, existing devices, or the Level API. The only risk is someone adding devices to your account. Contact Level support to rotate the key if needed.

  • The PKG installed but the Mac isn't showing up in Level. What should I check? Confirm that you ran the complete command from the Installer tab, or used the One-line command method. The PKG wizard alone doesn't complete enrollment. After setup and enrollment complete, wait 10–15 seconds and refresh. If it still doesn't appear, check that all three macOS permissions were granted and that an AV/EDR tool hasn't blocked the agent. See AV/EDR False Detections and Offline Troubleshooting.

Did this answer your question?