macOS Agent Installation
    • Dark
      Light
    • PDF

    macOS Agent Installation

    • Dark
      Light
    • PDF

    Article summary

    This article covers how to install the Edge DX Agent onto macOS devices.

    Important
    Before you deploy any Edge DX Agents, read the prerequisites for Agent deployment and make sure that your environment is ready.

    The following macOS versions are supported on Intel x64 or Apple Silicon (M1+)

    macOS versionMinimum Agent versionRecommended Agent version
    11.x (Big Sur)2.8Latest GA version
    12.x (Monterey)2.8Latest GA version
    13.x (Ventura)2.8Latest GA version
    14.x (Sonoma)2.8Latest GA version

    Download the Agent Manager

    To install the macOS Agent, you download and install the Agent Manager. The Agent Manager installs the Agent and updates it according to your version control settings

    To download the macOS Agent Manager:

    1. Go to Configuration > Downloads.
    2. Select macOS Agent.
    3. Click Download.

    Command line installation

    To install the macOS Agent Manager from the command line, follow the steps on the Downloads page. The commands are ready for you to copy and already include your unique tenant URL and device registration code.

    Manual GUI installation

    To install the Agent Manager manually, run the downloaded file. You'll need to enter your tenant URL and device registration code, which you can copy from the Agent Downloads page.

    User prompts for data collection

    Note
    This section describes using Extended Settings to control user prompts and data collection. You can target these settings to certain devices using groups and tags. Read Extended Settings for details.

    When the macOS Agent is installed on a device, the Agent requires permission to access certain data on the device. By default, the end user receives multiple prompts to grant these permissions to the Agent. This section describes the required permissions and user prompts, and how you can control data collection and user prompts for the relevant features.

    Network filter

    The end user is prompted to install and use a network filter. The network filter is used for Agent data collection from Microsoft Teams for UC&C monitoring, and collecting network bytes used per process.

    • If you want to use an MDM solution to grant these permissions, you can enable the setting Mac only: Prevent network filter user prompt to block the user prompts. You can then configure an MDM policy to allow the Agent to install and use the network filter.
    • If you don't want to use these features, you can enable the setting Mac only: prevent network filtering. This setting prevents data collection from a network filter (even if configured with an MDM policy) and also prevents relevant user prompts.

    Remote Control/Shadow

    The end user is prompted to give the Agent permission to view the screen and control the device for Remote Control/Shadow. 

    For more information about the required permissions for Remote Control, see How to Allow Remote Control on macOS.

    Location Services

    The end user is prompted to give the Agent permission to access location data from Location Services. Learn more about device geolocation in Edge DX.

    • If you want to use an MDM solution to grant this permission, you can enable the setting Mac only: prevent location user prompt to block the user prompt. You can then configure an MDM policy to allow the Agent to collect the location data.
    • If you don't want to collect location data from Location Services, you can enable the setting Disable device location. This setting prevents the user prompt for location data.

    Active URL collection

    The end user is prompted to give the Agent permission to get data from Chrome and Safari to collect active URLs for End User Activity monitoring.

    Uninstall the Agent with a script

    To perform a scripted uninstall of the Edge DX Agent for macOS, run this command as root:

    /usr/local/com.controlup.edgedx.agent/Bin/AgentAssist --uninstall



    Was this article helpful?