Back to Getting Started

Install the OpenFrame Agent on macOS

Device Deployment · Step 1

Section

May 15, 2026

Published

Aliaska Varieva

Aliaska Varieva

Head of Platform

Install the OpenFrame Agent on macOS

This guide walks you through installing the OpenFrame agent on a managed macOS device.

Prerequisites

  • Admin (sudo) access on the target Mac
  • The agent installer URL from your OpenFrame tenant dashboard
  • macOS 12 (Monterey) or later

Steps

  1. Download the installer
bash
curl -fsSL https://install.openframe.ai/macos -o openframe-agent.pkg
  1. Verify the package signature
bash
pkgutil --check-signature openframe-agent.pkg
  1. Run the installer with your enrollment token
bash
sudo installer -pkg openframe-agent.pkg -target /
sudo openframe enroll --token <YOUR_TOKEN>

Verify

Run openframe status — you should see Connected and the device should appear in your tenant within 60 seconds.

Next

Move on to Step 2: Install the OpenFrame Agent on Windows.