macOS Agent installation

The Nodeware macOS Agent is available for download in the Nodeware dashboard.

1. Click Customers (left side panel) and the Gear icon for the customer.

2. Select Agent Downloads and choose macOS.

It is important to install the Agent with an account that has admin privileges. Other access levels may produce errors during installation or prevent full functionality.

If the installer package is launched directly, it will launch a visual installer with several steps.

Note: Ensure the downloaded package does not have any extraneous characters in the filename, macOS will add (1) to a repeated download, the format must match the following:

Nodeware Agent for macOS.XXXXXXX.pkg

There must not be any additional characters to the seven digit customer ID between the dots in the filename, otherwise the agent will fail to register.

Requirements

• Supported version of macOS (12 Monterey, 13 Ventura, 14 Sonoma)
• Full Disk Access permissions
  • From System Settings:
    • Select Privacy & Security from menu
    • Click Full Disk Access
    • Enable toggle next to NodewareAgent

Other Deployment Methods

The macOS Agent can also be installed via command line, which is useful for deployment with MDM or RMM tools. Enter the following command line:

sudo installer -pkg 'Nodeware Agent for macOS.XXXXXX.pkg' -target /

The "XXXXXX" string will be a customer ID and is specific to the customer’s account. The ID can be changed to any valid customer ID, which can be found in both the dashboard (in the customer’s URL) and API, prefixed by "cus_." Only the numeric portion is used in the filename.

If assistance is needed with building a deployment package for Nodeware Agents, please click Support at the bottom right of this page.

Screenshots of Installation

Uninstall macOS Agent

To uninstall macOS agents, complete the following steps:

1. Open Terminal, change to the Nodeware directory. This may require sudo privileges.

cd /usr/local/bin/nodeware

2. Generate the removal script with the following command:

sudo ./NodewareAgent makeremovescript

3. Run the removal script to complete uninstall:

sudo ./tmp/nwcleanup.zsh

If the above script does not run, you may need to invoke Zsh directly, in the following format:

sudo zsh /tmp/nwcleanup.zsh