Add a macOS Device with an Agent Installer

Some customers may not have access to GUI-based installation. If you can only deploy the NinjaOne agent via command-line workflows, refer to Mass Deployment of NinjaOne Installer.

Topic

This guide provides instructions for generating a NinjaOne agent installer for a macOS device. Refer to our System Requirements and OS Support article before installing NinjaOne on your endpoints.

For information about installing the agent on Linux devices, refer to How to Install NinjaOne on a Linux Device.

For information about installing the agent on Microsoft Windows devices, refer to How to Install NinjaOne on a Windows Device.

Environment

NinjaOne Agent
Apple macOS

Description

If you are using Sophos, refer to this note about important changes to their application control policy: Action Required: Disable the optional setting for new applications.

As of February 2025, the NinjaOne RMM agent can be installed on all Apple Silicon devices without the need for Rosetta.

Select a category to learn more:

Generating a NinjaOne Installer
Copying a Link to the Installer
Installing the macOS Agent on a Device

Generating a NinjaOne Installer

To generate the NinjaOne Installer, you first need to set up an organization and create a policy.

To learn how to set up an organization, refer to NinjaOne Platform: Creating and Editing Organizations.
To learn how to configure a policy, refer to Policies: Create a New Policy.

Once you have set up an organization and created a policy in NinjaOne, click the + sign in the upper-right corner of the NinjaOne console and select Device.

Figure 1: Add a device in NinjaOne

Select Computer from the menu.
Select Mac and designate the Organization, Location, Device Role, and Distribution type to which this device belongs. Then, select the Generate Installer button.
Once the installer has been generated, you can download it using the Download button or copy the link to the installer to your clipboard using the Copy link button.

Do not rename the installer or mount multiple DMG (disk file) volumes with the installer. Doing so will interfere with the installer’s ability to correctly install and register with the system.

Copying a Link to the Installer

If you would like to send end users a link that they can click to download the installer, click Generate Installer and select Copy link.

This link may expire in the following circumstances:

Division cached installers are cleared.
A minor or major agent upgrade is released.
A bug fix for an installer-related issue has been released.

In all other circumstances, the download link will remain available for use.

Installing the macOS Agent on a Device

For devices on macOS Catalina (10.15) and higher, macOS requests manual approval for various Security & Privacy settings before opening downloaded software for the first time. The following steps will help you install the agent with macOS's enhanced Security & Privacy settings.

For the latest version of macOS Big Sur, installation steps may differ depending on your macOS version. Refer to the following external documentation for more details: Open a Mac app from an unknown developer - Apple Support (external link).

For some macOS devices, and for full usage of the file browser, you may also need to manually grant the NinjaOne agent labeled ninjarmm-macagent Full Disk Access to the computer. You can do so from System Preferences → Security & Privacy → Privacy → Full Disk Access.

Click the Finder tab on the device and locate the NinjaOne agent install file.

Figure 2: Open the Finder on a macOS device (click to enlarge)

Control-click the file, then select Open from the drop-down menu.

Figure 3: Open the NinjaOne agent install file on a macOS device

Click the installer icon and input any necessary credentials.

Figure 4: NinjaOne agent installer icon on a macOS device

Complete the NinjaRMMAgent Setup Wizard prompt.

Additional Resources

Refer to the following resource to learn more about the NinjaOne agent: NinjaOne Agent: Resource Catalog.