Installing or uninstalling the macOS Agent

SECURITY  Administrator

NAVIGATION  Devices > All > Add Device > enter a Managed site name > select a Managed site > macOS

NAVIGATION  Sites > All Sites > click the name of a Managed site > Add Device > macOS

IMPORTANT  For information about supported macOS versions, refer to Supported operating systems and Agent requirements. For information about which services get installed, refer to Services, dependencies, and folders (Windows, macOS, Linux).

IMPORTANT  In order for the Agent to function properly on macOS devices running Mojave or later, the following applications must be listed and selected for the following options in System Preferences > Security & Privacy > Privacy (or, for Ventura, System Settings > Privacy & Security > Privacy section):
• Accessibility: AEM Agent
• Full Disk Access: AEM Agent
• Screen Recording: AEM Agent

IMPORTANT  Installation will require entry of a local user password.

1. Refer to the steps outlined in Downloading the Agent or sharing the Agent installer.

NOTE  macOS devices can only be added to Managed sites.

NOTE  For information about manually enrolling other types of devices, refer to Adding a device.

2. Open the downloaded or emailed file and unpack the .zip file.
3. Open the AgentSetup folder and double-click the file called CAG.pkg.
4. Complete the wizard to install the Agent. Once the Agent has been installed, the Datto RMM icon will be displayed in the menu bar of your computer.

IMPORTANT  When changing the hostname of a macOS device through the command line (scutil --set HostName), make sure that you add .local to the hostname to prevent the Agent from crashing.

IMPORTANT   If FileVault is enabled, Datto RMM will not function after a reboot of the device, as the drive is encrypted until a user logs in. Logging in to the device decrypts the drive and allows applications to function.

1. Open Terminal.
2. Run the following commands:

						curl -o Agent.zip "https://platform.centrastage.net/csm/profile/downloadMacAgent/siteID"
							unzip Agent.zip
					sudo installer -pkg "AgentSetup/CAG.pkg" -target /

IMPORTANT  Make sure to replace platform and siteID with the appropriate values. The platform is included in the URL when you are logged in to Datto RMM (for example, https://concord.centrastage.net). You can find the site ID in Site Settings.

3. Complete the wizard to install the Agent. Once the Agent has been installed, the Datto RMM icon will be displayed in the menu bar of your computer.

1. Open Terminal.
2. Run the following command:

					sudo bash /Applications/AEM\ Agent.app/Contents/Resources/uninstall.sh

3. The Agent will now be uninstalled from the device.

If you have problems reinstalling the Agent on a macOS device, it may be necessary to completely remove the Agent from the device. After uninstalling the Agent using a local script, use one of the following methods:

Terminal

1. Open Terminal.
2. Enter the following commands, entering your password where prompted:

					sudo rm -rf /usr/local/share/Centrastage

and

					sudo rm -rf /var/root/.mono/registry/CurrentUser/software/centrastage

Finder

1. If your preference is to use Finder, ensure you have enabled root. You can do so by following the instructions in this article.

Using the instructions for Lion will also work for later versions.

2. Once the root user is enabled, type the following into Terminal to show all files in Finder:

					defaults write com.apple.finder AppleShowAllFiles

and then

					killall Finder

3. If you are using Mavericks 10.9 or later, add -boolean true to the end of the first command so it looks like this:

					defaults write com.apple.finder AppleShowAllFiles -boolean true

4. Delete the following directory:
   • /usr/local/share/Centrastage
   • /var/root/.mono/registry/CurrentUser/software/centrastage