Installing the Endpoint Agent on Windows
This article covers system requirements, downloading the installer, and installing the Endpoint Agent on Windows desktops and laptops.
Due to recent platform-wide naming, navigation, and URL changes in the ThousandEyes product, you might notice some discrepancies between the product and the screenshots displayed in our technical documentation. The instructions and actual pages in the product are still valid and haven't changed. See the full scope of changes on Naming and Navigation Menu changes - Summary List.
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:
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:
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
54.230.114.2, 54.230.114.11, 54.230.114.41, 54.230.114.123
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:
In the ThousandEyes web application, navigate to Endpoint Experience > Agent Settings.
Click the Add New Endpoint Agent button.
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.
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.
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:
In the ThousandEyes web application, navigate to Endpoint Experience > Agent Settings.
Click Add New Endpoint Agent.
Right-click the Download link for Windows and select Copy Link Address.
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
Launch the installer from the location on your machine.
Accept the terms of the license agreement in the installation wizard and click Next.
Follow the instructions in the installation wizard.
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.
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:
Navigate to Privacy & security in system settings.
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.
Last updated