Already a NinjaOne customer? Log in to view more guides and the latest updates.

NinjaOne Agent Installation: Add Device (macOS)

  • Last Updated June 29, 2026

Topic

This guide provides instructions for generating a NinjaOne Agent installer for an Apple macOS device.

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

Environment

  • NinjaOne Endpoint Management
  • NinjaOne Agent for Apple macOS

Description

The NinjaOne Agent installer is an executable file that installs the NinjaOne Agent on a device, enabling the device to be monitored and managed in NinjaOne. This guide explains how to generate the installer from the NinjaOne platform, download it to your device, and share an installer link with end users.

Before You Start

Before generating the installer, confirm that your environment meets the following requirements:

Generating a NinjaOne Installer

  1. In NinjaOne, click the Add icon and choose Device from the drop-down menu.
Figure 1: Add → Device (click to enlarge)
  1. Select Device from the menu.
  2. The Add a computer window will open.
  3. Select Mac from the operating system options.
  4. Select the appropriate Organization, Location, Device Role, and Distribution type values.
  5. Click Generate Installer.
  6. NinjaOne will surface a prompt alerting you that the installer has been generated successfully.
  7. After 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. [VERIFY WITH PM: Add full click path for Download and Copy link UI elements.]

Do not rename the installer or mount multiple Apple Disk Image (DMG) volumes with the installer. Doing so will interfere with the installer’s ability to correctly install and register with NinjaOne.

Sharing a Link to the Installer

To send end users a link 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.
Do not use URL shorteners with NinjaOne installation links. Shortened links obscure the original URL, increasing the risk of input errors, and can be used by unintended parties to install the NinjaOne Agent on unknown devices in your organization.

Installing the macOS Agent on a Device

Apple macOS Monterey (12) and later requires manual approval for certain Security & Privacy settings before opening downloaded software for the first time. Follow the steps below to install the NinjaOne Agent with these settings enabled.

  1. Click the Finder tab on the device and locate the NinjaOne Agent install file.
  2. Control-click the file, then select Open from the drop-down menu.
  3. Click the installer icon and input any necessary credentials.
  4. Complete the NinjaOne Agent Setup Wizard prompt.

For macOS Monterey and later, installation steps may differ depending on your macOS version. Refer to the following external documentation from Apple for more details: Open a Mac app from an unknown developer (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. Navigate to System Preferences → Security & Privacy → Privacy → Full Disk Access to grant this access.

Additional Resources

The following articles provide additional guidance for deploying the NinjaOne Agent to other platforms and environments.

FAQ

Next Steps