Push Install Windows and Mac Agents

Rather than install the Windows or Mac Agent onto each device manually (or via Group Policy for Windows), you can Push Install the Monitoring Agent to the target devices directly from the RMM Dashboard.

Push Install is available through Network Discovery, using technology included in the Discovery Agent. After you select Push Install, the Discovery Agent downloads the installation package, begins the deployment process to the selected devices on the network and applies the Monitoring Template policy (if configured).

Push Install deploys the latest General Availability version of the Monitoring Agent.

Target Device Requirements

  1. The selected devices must be online when you select Push Install because Push Install does not incorporate a queuing or scheduling mechanism.
  2. Windows requirements:
    • Domain or Admin Shares remotely accessible—Push Install only deploys on devices that are part of a Domain or have Admin Shares remotely accessible
    • File and Printer Sharing—Target device's local firewall must be configured to allow File and Printer Sharing.
  3. Mac requirements:
    • Remote Login—Configured either through the Terminal or System Preferences Sharing, this setting enables standard SSH login for remote terminal access

Discovery Agent Version Identification

Display the Network's Current Discoverer

  1. Log into the RMM Dashboard
  2. Choose the target online network in the Networks tab of the North-pane
  3. Go to the South-pane Summary tab
  4. The network's Current Discovery Agent (current discoverer device) appears under Network Details

Check the Current Discovery Agent Version

  1. Go to the Connected Devices tab
  2. Search for the Current Discovery Agent (current discoverer device)
  3. Right-click the device and select Edit Device
  4. The Network Agent Version (Discovery Agent Version) appears under Device Information in the Device Details dialog


Push Install

  1. Log into the RMM Dashboard
  2. Choose the target network in the Networks tab of the North-pane
  3. Go to the South-pane Connected Devices tab
  4. Make the device selection. For easy identification, the Agent column denotes whether a Monitoring Agent is installed, along with the Client and Site it is registered under
  5. Single Device

    1. Right-click the target device in the South-pane
    2. Select Push Monitoring Agent to Device
    3. This option is only available for Devices running supported versions of Windows or Mac without a Monitoring Agent. Where these conditions are not met, only Edit Device is selectable.


    Multiple Devices

    1. Select the target device(s) in the South-pane. Use Shift and left-click to choose a range of devices or Control and left-click for specific machines
    2. Right-click one of the selection
    3. Select Push Monitoring Agent to Device
    4. When using multi-select, the option to Push Monitoring Agent to Device is selectable. However, the Monitoring Agent is only pushed to eligible devices running supported versions of Windows or Mac without a Monitoring Agent.


Configure Push Install Settings

Regardless of the selection method used, the next stage is to enter the credentials and information required to push the Agent to the device(s).

When different devices have different credentials or are to be registered under different Clients or Sites, they must be pushed separately.

  Field Description
Client The Client the Device will appear under on the Dashboard
Site The Site the Device will appear under on the Dashboard
Admin Credentials Admin Username Windows Administrative username for the domain or device
Admin Password Windows Administrative password for the domain or device

For security all passwords are transmitted in an encrypted state via SSL protected protocols.

Mac Push commands require the login credential of a user with administrative privileges capable of executing sudo commands via terminal
Proxy Server Settings Enabled Enable where the device connects to the internet through a proxy
Address Enter the IP address, not the NetBIOS name
Port Enter the port the connection is going through
Username The username the proxy requires for authentication.

Ensure the selected user has sufficient privileges to use the proxy.

The Username must be in the format DOMAIN\username

Password The password the proxy requires for authentication.

Run Preliminary Checks

After entering these details, and before attempting the installation, preliminary checks are done on the devices to ensure they meet the eligibility criteria and are setup correctly for Push Install. A real-time progress bar displays the number of devices checked and the current Pass / Fail / Unknown totals.

You can minimize the progress bar. The minimized progress indicator displays in the lower right corner of the Networks tab's South-pane. Click the indicator to display the full progress bar at any time.

The preliminary checks continue to run on the selection even if you log out of the Dashboard or refresh your window.

ad_progress ad_push_mini

When the checks are complete, a summary of the results indicates whether the pre-checks passed or failed (issues were discovered that may prevent a successful Push Install).

Where the pre-checks failed, you can download a list of devices and their corresponding issues to investigate. After resolving these issues, you can then rerun Push Install on those devices.

Choose Continue to proceed with the installation on those devices where the preliminary checks passed.

If all devices failed these checks the Continue option is unavailable.

ad_all_passed ad_check_fail

Windows - Admin Share Troubleshooting Steps

Verify the device’s Admin Share is accessible from the Discovery Agent by connecting to the \\TARGET_COMPUTER_NAME\admin$ share on the target system.

If problems are experienced when connecting to the share, verify:

  • File and Printer Sharing is allowed through the local firewall
  • Simple file sharing is disabled (Tools > Folder Options > View - remove check from the Use Sharing Wizard box and OK to apply)
  • Admin shares are present and are remotely accessible (Start > compmgmt.msc > Shared Folders > Shares look for ADMIN$). Causes of the Access Denied messages when attempting to connect to an Admin Share on a workgroup computer are covered in the section Admin Share - Access Denied.
  • The entered account has the necessary administrative credentials to remotely access the selected computers
  • The RPC service is running on the target system (Start > services.msc look for Remote Procedure Call (RPC) Service and start if necessary)

Mac - Enable Remote Login

You can enable Remote Login for Mac in two ways: Terminal commands or Sharing preferences.

Terminal commands

Open a Terminal session on the target Mac device (available in the Utilities folder Shift+Command+U)) then as an administrator enter the following commands to enable and configure Remote Login:

Enable Remote Login:

systemsetup -setremotelogin on

Create the com.apple.access ssh group:

dseditgroup -o create -q com.apple.access_ssh

Add the administrator group to com.apple.access_ssh

dseditgroup -o edit -a admin -t group com.apple.access_ssh

Sharing preferences

  1. On the target Mac computer:
  2. Open Sharing preferences (Apple menu, System Preferences)
  3. Tick the checkbox against Remote Login to enable
  4. Choose Allow access for settings; for security we would suggest using the Only these users to limit remote access; for example to Administrator users


Once complete the Discover Agent retrieves the installation package, begins the deployment process and applies the Monitoring Template policy (where configured).

It may take several minutes for the installation to complete and for the Connected Devices tab and Activities tab to indicate an Agent was successfully installed.

Where the install was successful, the device appears in the Servers or Workstations section of the Dashboard (depending on the device type) under the selected Client and Site.

Please be aware that the Windows Monitoring Agent installs in the default mode for the device type (Server Mode on servers, Workstation Mode on workstations). The option to install the Agent in Server Mode is only available when manually installing the Agent.

Activities Tab

The current status of the install is displayed against the device in the South-pane Activities tab. The Activities tab does not automatically refresh. Click the reload button to refresh the South-pane.

Three indicators for the current installation status are returned.

Icon Description


Active installation

Green Tick

Successful installation

Red Cross

Installation failed.

Hover over the Agent Push Install error for details of potential causes of the failure, for example login or firewall issues