Skip to main content

macOS Service Account

How the Level service account works on Apple Silicon Macs, why it exists, and how to manage it manually.

Updated today

Introduction

On Apple Silicon Macs (M1/M2/M3), Level creates a dedicated service account to support patch management. This account is required so Level can unlock FileVault and install updates without an interactive user session.

It's created automatically during agent installation. If you skipped the prompt at install time or need to manage it later, you can do so via the command line.


What the Service Account Is

The Level service account is a system account with a single purpose: installing updates. It's not a user account in any practical sense.

  • No admin privileges

  • No login privileges (no home folder, no shell)

  • Hidden in the login window and Users & Groups preferences

  • If FileVault is enabled, the account is visible at startup and can unlock the drive

  • Removed automatically when the Level agent is uninstalled

ℹ️ NOTE: The service account is Apple Silicon-only. Intel Macs don't require it because the patch management flow on Intel doesn't need to unlock FileVault at startup.


Manual Setup

If the service account wasn't created during install, run this command on the target device:

/usr/local/bin/level --create-service-account

You'll be prompted for an admin username and password. These credentials are for an existing system admin on the device β€” they're used to authorize the creation of the service account, not to set its password.

πŸ’‘ TIP: For scripted or MDM-based setup, pass credentials as flags to skip the interactive prompt:

Example

/usr/local/bin/level --create-service-account --admin-name=adminuser --admin-password=adminpass

CLI Reference

ℹ️ NOTE: All service account options are Apple Silicon-only. Running them on an Intel Mac will have no effect.

All options require the full path to the Level agent binary: /usr/local/bin/level

Option

Description

--check-service-account

Checks whether a Level service account exists on this device

--create-service-account

Creates a new Level service account

--delete-service-account

Removes the Level service account

--admin-name=

Admin username for --create-service-account (non-interactive)

--admin-password=

Admin password for --create-service-account (non-interactive)

⚠️ WARNING: Deleting the service account with --delete-service-account will prevent Level from installing updates on this device until the account is recreated.


FAQ

  • Why does Level need a service account just to install updates? macOS requires FileVault to be unlocked before the system can install updates at startup. The service account gives Level a way to perform that unlock without an interactive user session.

  • Will my users see this account? No. The service account is hidden in the login window and in System Settings β†’ Users & Groups. It only appears at the startup FileVault unlock screen on devices with FileVault enabled.

  • I dismissed the credential prompt during install. Do I need to set the account up? Only if you want Level to handle patch management on this device. Run --create-service-account manually or push it via your deployment tooling. Monitoring, remote control, and other features work without it.

  • Can I automate service account creation at scale? Yes β€” use --admin-name= and --admin-password= flags to pass credentials non-interactively. These can be passed as part of a post-install script in your MDM or deployment tool.

  • What happens to the service account if I uninstall Level? It's removed automatically as part of the uninstall process.

Did this answer your question?