Manual Installation—Mac Agent
To manually install the Mac Agent on a Mac workstation, select these steps and following the instructions:

To download and install the Agent you must have the appropriate N-sight RMM User account permissions. For information about Agents permissions, see Default system roles and their permissions.
Depending on the configuration of the computer it may need local administrator authorization.
- On the N-sight RMM Dashboard, go to Agent > Download Agent
- Select the version of the Mac Agent to download
The DMG file, which contains the required Mac Agent PKG, is downloaded to the workstation. Next, see 2. Install the Mac Agent on the workstation.

To optimize installation time and ensure Check and Automated Task consistency across devices, you can Configure default Monitoring Templates for installation.
- On the workstation, go to the download directory (available in the Finder sidebar or the Dock)
- Double-click the DMG to open (for example. OSX_AGENT_3_8_0.DMG)
- Double-click Install to start the Mac Agent installation wizard that first checks to ensure the Agent can install
- Click Continue to proceed through each section of the wizard
- Choose to register the Agent now or after the installation
Choice Action Register Agent now - You are prompted to enter the Dashboard Username and Password
- Enter a Description for the device and the Dashboard Client and Site it should be registered under
If required, configure the Proxy server settings when launching the Agent after installation.
Register after installation manually After installation, you are prompted to enter the N-sight RMM Dashboard credentials and device information when you launch the Agent. For more information, see 3.Register the Mac Agent against the Dashboard.
- Click install and when prompted enter the password of the user you logged into the Mac under to authorize
- Click Close once complete
For macOS Mojave (10.14) and later, if a device is not enrolled in Device Management for Apple, you must Enable Accessibility and Full Disk Access permissions for rmmagent for that device.

You only manually register the Mac Agent if you manually installed the Mac Agent, and selected Register after installation manually in the installation wizard.
You can register the Mac Agent from within the Monitoring Agent or from a terminal.
Option 1: Using the Monitoring Agent
- On the Mac workstation, open Finder
- Go to Applications > Utilities
- Double-click Advanced Monitoring Agent
- When prompted enter N-sight RMM Dashboard login Username and Password
- Complete the Proxy server settings (if required)
- Enter the Device Description and select the Client and Site combination from the drop-downs
- Click OK to finish the registration process
Option 2: Using the Terminal (Command Line)
Register the Monitoring Agent from its installation directory: /usr/local/rmmagent
- Click Finder > Go > Utilities
- Double-click Terminal
- Navigate to the Agent installation directory
-
Enter the register command for the rmmagentd daemon either as root or by assuming root privileges by sudo, providing the computer's password where prompted. Complete the information then enter Yes to register the Agent with the Dashboard.
$ cd /usr/local/rmmagent/
$ sudo ./rmmagentd register
*** Agent registration ***
Username:
Password:
Your current Clients:
0) Create new Client/Site
1) Alpha
2) Beta
Select the Client Number: 2
Sites for Client Beta:
0) Create new Site
1) Site A
2) Site B
Select Site number: 1
Device description: Bruce MacBook
Please check registration data:
Client: "Beta"
Site: "Site A"
Device: "Bruce MacBook"
Want to continue registration? Answer 'yes' or 'no': yes
Successfully registered
Register Agent (quiet)
You can send the registration information to the N-sight RMM Dashboard using the quiet switch. Enter the register command for the rmmagentd daemon either as root or by assuming root privileges by sudo, providing the computer's password where prompted.
To avoid any command failures due to blank space or special characters, we recommend you encapsulate them in quotation marks.
$ sudo /usr/local/rmmagent/rmmagentd register --quiet --username=dashboard_user@example.com --password=Password321 --Client=Beta --Site="Site A" --desc="Bruce MacBook"
Registration succeeded.
Information displays as plain text in the terminal when using this option.
Quiet Register Command Switches
The following switches are available when using the quiet option to register the Agent.
$ sudo /usr/local/rmmagent/rmmagentd register help
Application command line error: Unexpected option argument: help
usage: rmmagentd register [--quiet --username=<username> --password=<password> --client=<client>
--site=<site> [--description=<description>] [--create-client] [--create-site]]
Register agent
-q, --quiet Quiet registration
-u<user>, --username=<user> User name
-p<password>, --password=<password> Password
-c<client>, --client=<client> Client name
-s<site>, --site=<site> Site name
-d<desc>, --description=<desc> Server description (optional)
-C, --create-client Create client (and site) if not exists
-S, --create-site Create site if not exists
When these steps are complete, the Mac workstation displays in the N-sight RMM Dashboard North-pane Workstation tab, for the selected Client and Site.
Any amendments to the Mac Agent (changes to the settings or Check management) are configured and performed from the N-sight RMM Dashboard.