Agent Installation Overview
    • Dark
    • PDF

    Agent Installation Overview

    • Dark
    • PDF

    Article Summary

    To monitor physical devices, you need to install the Edge DX Agent onto the devices.

    Network Requirements

    Devices with the Edge DX Agent installed need to have TCP 443 / SSL outbound connectivity to:

    • https://[tenant-name]

    You can find your tenant name by going to Settings > Downloads

    Agent Whitelisting

    Whitelist the following directory in your antivirus software - C:\Program Files\Avacee\sip_agent\

    If you use SSL inspection, then you must disable SSL inspection for your Edge DX tenant URL https://[tenant-name] The Edge DX Agent is not able to communicate with your tenant if SSL inspection is enabled.

    Troubleshooting network connection problems

    Read the Agent connection troubleshooting section below if you are having connection problems.

    Download and Install the Edge DX Agent

    To download the Edge DX Agent for your OS, go to the Agent Downloads page.

    If you access Edge DX using ControlUp's DEX management platform (, click on the Device icon and go to Configuration > Downloads.

    If you access Edge DX using Solve ( or by direct tenant URL (<tenant-name>, go to Configuration > Downloads.

    Click the links below for detailed installation instructions for:

    Agent Manager and Version Control

    For Windows and macOS devices, you can install the Agent Manager which installs the Agent and keeps it up-to-date. By default, the Agent Manager installs the latest GA version of the Agent. For details, visit Agent Version Control.

    Agent Distribution

    To distribute the Edge DX Agent to end-user devices, use any of the following methods:

    1. Distribute the Edge DX Agent, tenant name, and device registration code through an internal file share solution or by email.
    2. Distribute the Edge DX Agent as an application, using a management solution such as Microsoft Intune or Microsoft Endpoint Configuration Manager.
    3. Copy the Edge DX Agent into a master image that is used to provision new devices for users.

    Agent Connection Troubleshooting

    If you have a proxy, firewall, or use antivirus software, make sure that you perform the necessary whitelisting described above.

    Use the following troubleshooting methods to help you identify if something is interfering with your network connection. For example, your company's security team might use a transparent proxy that you aren't aware of.

    Method 1 - Send a Post Request to Your Tenant

    Run the following command from the machine you are installing the Agent on. Replace [tenant-name] with your own tenant name.

    curl - v https://[tenant-name]

    The command sends a POST request to your tenant. If you don't receive a successful response, then something is intercepting the network connection to your tenant.

    Method 2 - Check Your Tenant's SSL Certificate

    From the machine you are installing the Agent on:

    1. Open Edge DX in your browser.
    2. Click the Lock icon next to the URL.

    3. View the details of the SSL certificate. This procedure is slightly different depending on your browser. In Google Chrome for example, go to Connection is secure > Certificate is valid.
    4. Check the issuer of the certificate.

    ControlUp always uses DigiCert for the SSL certificate. If you see any issuer other than DigiCert, then something is intercepting the network connection to your tenant.

    Was this article helpful?