Installing the Endpoint Agent on Windows

This article covers system requirements, downloading the installer, and installing the Endpoint Agent on Windows desktops and laptops.

System Requirements

To install and run the Endpoint Agent on Windows, you must have the following:

• A supported operating system

• A supported browser (if you use Real User Tests)

• Network connections to ThousandEyes hosts

• The minimum required memory

Any browser and operating system combination not explicitly identified below is not supported. This includes Firefox and Safari browsers on Windows.

Supported Operating Systems

The Endpoint Agent is supported on:

• Windows 10 (including Windows 10 Enterprise and Windows 10 IoT Enterprise) or higher

• For ARM-based Windows machines, Windows 11 or higher via emulation

Supported Windows Architectures

The Windows MSI installer comes in two versions:

• x86 version for 32-bit processors (but can be used with 64-bit processors)

• x64 version for 64-bit processors

Supported Browsers

The following web browsers are certified for operation with the Endpoint Agent browser extension on Windows:

• Chrome 41+ (Google Chrome Extension version 1.215.0 in the Chrome Store for Windows packages running on ARM via emulation)

• Microsoft Internet Explorer 11+

• Microsoft Edge 79+

Internet Explorer Compatibility Mode

The table below indicates which data the Endpoint Agent can collect with Internet Explorer 11 running the following emulations:

Emulation	Page Title	URL	Page Timing	Page Objects
Internet Explorer 8.x	x	x
Internet Explorer 9.x	x	x	x
Internet Explorer 10.x	x	x	x	x

Network Connections

The Endpoint Agent requires network connections to the following:

Host Name	Corresponding IP Addresses
USA region https://data.eb.thousandeyes.com	13.248.210.21, 76.223.72.156
USA region https://data.eb.us1.thousandeyes.com	13.248.210.21, 76.223.72.156
EU region https://data.eb.eu1.thousandeyes.com	52.223.46.66, 35.71.156.36
USA region https://c1.eb.thousandeyes.com	75.2.45.13, 99.83.250.143
USA region https://c1.eb.us1.thousandeyes.com	75.2.45.13, 99.83.250.143
EU region https://c1.eb.eu1.thousandeyes.com	35.71.129.45,52.223.12.120
USA region https://c1.eb.us2.thousandeyes.com	3.33.193.79,15.197.204.141
USA region https://data.eb.us2.thousandeyes.com	3.33.163.103,15.197.189.166
https://downloads.thousandeyes.com	54.230.114.2, 54.230.114.11, 54.230.114.41, 54.230.114.123

To run instant tests from Endpoint Agents, allow secure WebSocket connections to c1.eb.thousandeyes.com/relay/connect.

For the downloads page, the IP addresses listed above are examples. Download pages are served by CloudFront (CDN), so IP addresses are dynamic depending on the client's location.

Proxy Access

If the Endpoint Agent is behind a proxy that performs full TLS decryption, the signing certificate of the proxy must be accessible to the browser running the Endpoint Agent, or the sites above must be added to an exclusion list so that HTTPS interception is disabled.

Ensure the SYSTEM account can authenticate or is exempt from authentication for proxy domains. The te-proxy utility is provided as a workaround, but is not the recommended approach.

Memory

The Endpoint Agent requires less than 50 MB of RAM and less than 500 MB of disk space.

Downloading the Installer

Access to the Endpoint Agent installer from the ThousandEyes application requires a ThousandEyes user account with the Download Endpoint Agents permission for the account group (for example, the built-in Account Admin or Organization Admin roles).

To download the Endpoint Agent for Windows:

1. In the ThousandEyes web application, navigate to Endpoint Experience > Agent Settings.

2. Click the Add New Endpoint Agent button.

1. Select the relevant Endpoint Agent radio button:

   • Endpoint Agent

   • Endpoint Agent Pulse

   Note: For more information about Endpoint Agent vs Endpoint Agent Pulse, see Endpoint Agent.

2. Click the Download button for Windows to download the MSI installation file.

   A pop-up notification might appear after you select Download (depending on local security settings). Select Keep to continue the download process.

3. Continue with Installing the Endpoint Agent below.

Shareable Installer Links

You can generate shareable download links for users who do not need access to the ThousandEyes web application:

1. In the ThousandEyes web application, navigate to Endpoint Experience > Agent Settings.

2. Click Add New Endpoint Agent.

3. Right-click the Download link for Windows and select Copy Link Address.

4. Share this address along with the corresponding Connection String.

Share the connection string securely to avoid unauthorized access to your account group.

Customized Installer Links

The method of installation using customized installers has been deprecated and will not be available after June 20, 2024. Previously downloaded customized installers can still install the agent.

Installing the Endpoint Agent

The Windows installer package (MSI) installs all components necessary for the Endpoint Agent to function. The MSI can be invoked interactively by a user with administrative privileges on the target machine, or silently from the command line.

To install the Endpoint Agent, run the graphical installer. The installer requires the user to agree to the software license to proceed.

Interactive Installation

1. Launch the installer from the location on your machine.

2. Accept the terms of the license agreement in the installation wizard and click Next.

3. Follow the instructions in the installation wizard.

4. Provide the Connection String to register the agent with the correct account group in the ThousandEyes platform.

   

   Alternatively, skip entering the connection string and run the following command after installation from an administrator console:

   te-agent --register <connection_string>

For additional configuration options, including browser extension installation and Extended Network Tests support, see Endpoint Agent Installation Reference for Windows.

Do not install the Google Chrome and Microsoft Edge browser extensions via the installer if they might conflict with existing Group Policy settings.

If you use Group Policy to manage browser extensions, do not select the Browser Extension option during installation. Add the browser extension separately using Install the Endpoint Agent Browser Extension on Windows or Installing Browser Extensions for Windows via Group Policy.

1. Upon successful installation, the Endpoint Agent does not create entries under the Applications Menu. All Endpoint Agent products are installed at C:\Program Files (x86)\ThousandEyes\.

Silent Installation

Install silently or schedule silent installation as part of a script:

msiexec.exe /i <path_to_msi> /quiet /norestart ACCOUNT_CONFIG="<connection_string>"

The Connection String parameter determines the account group with which the agent registers.

Example with logging:

msiexec.exe /i "C:\Endpoint Agent-x86-1.2.0.msi" /quiet /norestart ACCOUNT_CONFIG="<connection_string>" /qn /l*vx "C:\ThousandEyesInstall.log"

Alternatively, install without registering during setup:

msiexec.exe /i <path_to_msi> /quiet /norestart

Then register from an administrator console:

te-agent --register <connection_string>

For browser extension flags, Extended Network Tests, and other command-line options, see Endpoint Agent Installation Reference for Windows.

The Endpoint Agent does not require a machine restart upon installation. Windows or your IT policy might require a reboot. ThousandEyes recommends using the /norestart flag. If silent installation fails, check the output log file for details.

Endpoint Agent Wi-Fi Reporting on Windows 11 (24H2) and Later

To align with Microsoft guidelines, ThousandEyes recommends enabling location services to accurately report SSID or BSSID information for the connected Wi-Fi access point.

To enable Location Services:

1. Navigate to Privacy & security in system settings.

2. Expand the Location tab and toggle on Location services. See Microsoft's location service documentation.

If you do not enable location services, the ThousandEyes UI displays Unknown SSID—Agent Name / Unknown BSSID—Agent Name.

Verify Your Installation

Upon successful installation, installed files appear in C:\Program Files (x86)\ThousandEyes\Endpoint Agent:

You can uninstall the agent from Add/Remove Programs in Control Panel or Apps & Features in Settings:

For enterprise deployment at scale, see Install Endpoint Agents for Windows via Group Policy.