Uninstall the Mac Agent

If you no longer require N-sight RMM for a Mac device, you can remove it from the All Devices view and the Mac Agent automatically uninstalls from the device. If needed, you can also manually remove the Mac Agent from a device.

What happens when you uninstall the Agent

  • When you delete a device from the All Devices view, the Agent is uninstalled and all associated data is permanently removed from the database. This includes all information related to the Client, Site, and Device. This action cannot be undone.
  • All features and checks deployed by the Agent are removed. This may take longer than expected, depending on the number of programs being uninstalled.
  • If the Agent is removed using a method outside the All Devices view (for example, manually), you can configure alerts to notify you when the removal is complete. See Configure alerts for Agent removal.
  • The User Audit Report logs device deletions, including:
    • Date and time of removal
    • Client, Site, and Device details
    • Username
    • Action taken (for example, Agent Uninstalled Manually from Device)

Uninstalling the Mac Agent does not automatically unenroll the device from Device Management for Apple unless you select that option during the automatic uninstall process or manually remove the MDM enrollment profile. For details, see Remove an enrollment profile manually.

Automatically uninstall the Mac Agent

You can automatically uninstall the Mac Agent by deleting the device from the All Devices view.

You must be signed in with an account that has the Devices permission in the General permissions section. If your account doesn’t have these permissions, the delete option won’t be available.

    1. In the All Devices view North-pane, right-click the devices you want to delete. To select multiple devices, use Shift + left-click for a range or Control + left-click for specific devices.
    2. Select Delete <device type> or Delete <device type> > Delete from Dashboard.
    3. Review the summary to confirm the number of devices selected for deletion.
    4. If the devices are in DMA, select Unenroll all selected devices from DMA.
    5. Review the summary and select OK to confirm deletion.

      The Agent removal process may take up to an hour to complete, depending on the Agent cycle.

Although the uninstallers for the Agent and installed features are run, some files and folders may remain on the device.

Manually uninstall the Mac Agent

When you manually uninstall the Mac Agent, the uninstall is reported to N-sight RMM and the device is removed from the All Devices view(if is was not already removed).

You can manually uninstall the Mac Agent using on of the following methods:

  • Rerun the Agent Installer and select Uninstall.
  • Run the uninstall.tool in Terminal (Command Line).

Option 1: Use the Agent Installer

  1. Open the Downloads folder (available in the Finder sidebar or the Dock).

    If the Agent installation package is deleted from the computer, you can download another installation package using Agent > Download Agent on the All Devices view.

  2. Double-click the Agent disk image file (for example: OSX_AGENT_3_8_0.DMG).
  3. Select Uninstall.
  4. Review the warning and proceed.
  5. Enter the Mac Device user admin password when prompted.
  6. Select OK to begin the uninstall process.

.PKG installers do not offer the uninstall option.

Option 2: Use Terminal (Command Line)

  1. Open Finder > Go > Utilities.
  2. Double-click Terminal.
  3. Navigate to the Mac Agent installation directory.

    4. $ cd /usr/local/rmmagent/

  4. Run the uninstall script with elevated privileges. You'll be prompted to enter the admin password.

    $ sudo ./uninstall.tool
    Password:
    Service rmmagentd not running
    Advanced Monitoring Agent removed.

Do not use Trash or Launchpad to remove the Agent. These methods do not fully uninstall the Agent or its associated features.

What do you want to do?