Skip to content

macOS agent

The Outpost agent runs on Macs as a preview. It manages a Mac much as it manages a Windows or Linux computer: inventory, scripts, patching, software, policy, and remote desktop, with the tray app in the menu bar. This page covers what works, the permissions macOS asks for, and how the preview package installs.

The agent supports macOS 14 and later, on Apple silicon and Intel Macs.

AreaOn macOS
InventoryHardware, software, patches, certificates, browser extensions, USB devices, drivers, services, users and sessions, security state, and more. Windows-only items, such as optional features and activation, are reported as not applicable.
Live metrics and process listYes
Remote terminalYes
Scriptssh, bash, zsh, and Python, as root or as the signed-in user, and at sign-in
Remote desktopYes, with the Screen Recording permission. Input needs the Accessibility permission.
PatchingmacOS Software Update
Software deploymentHomebrew formulas and casks, and .pkg and .dmg installers
PolicyPassword policy, firewall, Gatekeeper, screen lock, guest account, Remote Login, automatic updates, and FileVault, with the recovery key escrowed to your Outpost
Local administrator password rotationYes
Restart, shut down, lock screen, sign out, and message a userYes
Outpost SyncNo
Tray appYes, in the menu bar

Homebrew installs need Homebrew on the Mac. A Homebrew package sent to a Mac without it fails with a reason rather than installing anything else.

See Supported platforms for the full comparison with the other platforms.

macOS protects the screen, input, and some folders with privacy permissions that root does not bypass. Each one is granted to outpost-agent once, by someone at the Mac, unless your MDM grants it.

PermissionNeeded forWithout it
Screen RecordingSeeing the screen in a remote desktop sessionThe session does not open, with Screen Recording permission is not granted to Outpost on this Mac
AccessibilityMouse and keyboard input in a remote desktop sessionThe session is view only
Files and Folders (Desktop, Documents, Downloads, and removable and network volumes)Browsing and transferring files in those folders during a remote sessionThe person at the Mac is asked to allow access. Until they do, the transfer stops with a message asking them to select Allow
Full Disk AccessOptional. Grants every protected folder at onceFolder access is asked for per folder, as above

With an MDM, you can pre-approve Accessibility and folder access with a Privacy Preferences Policy Control profile. MDM cannot grant Screen Recording. It can only let a standard user turn it on. Someone at the Mac still has to allow it.

The macOS options in Enroll a device, macOS Apple silicon and macOS Intel, appear only when macOS installers are turned on for your Outpost.

The download is a .zip holding the package and agent.json:

  1. Extract the whole .zip into one folder. agent.json must stay beside the .pkg.

  2. Open the .pkg from that folder, or install it from Terminal:

    Terminal window
    sudo installer -pkg outpost-agent-darwin-arm64.pkg -target /

The package installs the agent to /usr/local/outpost and the tray app to /Applications/Outpost Tray.app, applies agent.json, and starts the agent as the LaunchDaemon com.outpost.agent.

To check the agent:

Terminal window
sudo launchctl print system/com.outpost.agent

The agent’s log is /var/log/outpost-agent.log.

Content is licensed CC BY 4.0. Code samples are MIT. Outpost and the Outpost mark are trademarks of Outpost Business Solutions, PBC and are not covered by either license.