> For the complete documentation index, see [llms.txt](https://docs.thousandeyes.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/installing/windows/install-the-endpoint-agent-on-windows.md). # Installing the Endpoint Agent on Windows This article covers system requirements, downloading the installer, and installing the Endpoint Agent on Windows desktops and laptops. {% hint style="warning" %} 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](https://docs.thousandeyes.com/whats-new/naming-and-nav-phase-2-changes). {% endhint %} ## System Requirements To install and run the Endpoint Agent on Windows, you must have the following: * A supported [operating system](#supported-operating-systems) * A supported [browser](#supported-browsers) (if you use Real User Tests) * [Network connections](#network-connections) to ThousandEyes hosts * The minimum required [memory](#memory) {% hint style="info" %} Any browser and operating system combination not explicitly identified below is not supported. This includes Firefox and Safari browsers on Windows. {% endhint %} ### 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 | 13.248.210.21, 76.223.72.156 | | USA region | 13.248.210.21, 76.223.72.156 | | EU region | 52.223.46.66, 35.71.156.36 | | USA region | 75.2.45.13, 99.83.250.143 | | USA region | 75.2.45.13, 99.83.250.143 | | EU region | 35.71.129.45,52.223.12.120 | | USA region | 3.33.193.79,15.197.204.141 | | USA region | 3.33.163.103,15.197.189.166 | | | 54.230.114.2, 54.230.114.11, 54.230.114.41, 54.230.114.123 | {% hint style="info" %} 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. {% endhint %} #### 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. ![](/files/OcOZ09wecNts4A1VuPfH) 3. 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](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents#introduction-to-endpoint-agents). 4. 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. 5. Continue with [Installing the Endpoint Agent](#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](/product-documentation/global-vantage-points/endpoint-agents/installing/windows/endpoint-agent-installation-reference.md#connection-string). {% hint style="warning" %} Share the connection string securely to avoid unauthorized access to your account group. {% endhint %} ### Customized Installer Links {% hint style="info" %} 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. {% endhint %} ## 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](/product-documentation/global-vantage-points/endpoint-agents/installing/windows/endpoint-agent-installation-reference.md#connection-string) to register the agent with the correct account group in the ThousandEyes platform. ![](/files/WvQsvI2NyeJl7zJ18GJN) Alternatively, skip entering the connection string and run the following command after installation from an administrator console: `te-agent --register ` {% hint style="info" %} For additional configuration options, including browser extension installation and Extended Network Tests support, see [Endpoint Agent Installation Reference for Windows](/product-documentation/global-vantage-points/endpoint-agents/installing/windows/endpoint-agent-installation-reference.md). Do not install the Google Chrome and Microsoft Edge browser extensions via the installer if they might conflict with existing [Group Policy settings](/product-documentation/global-vantage-points/endpoint-agents/installing/windows/install-endpoint-agent-for-windows-via-group-policy.md). 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](/product-documentation/global-vantage-points/endpoint-agents/installing/windows/install-the-browser-extension.md) or [Installing Browser Extensions for Windows via Group Policy](/product-documentation/global-vantage-points/endpoint-agents/installing/windows/install-browser-extension-via-group-policy.md). {% endhint %} 5. 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 /quiet /norestart ACCOUNT_CONFIG=""` The [Connection String](/product-documentation/global-vantage-points/endpoint-agents/installing/windows/endpoint-agent-installation-reference.md#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="" /qn /l*vx "C:\ThousandEyesInstall.log"` Alternatively, install without registering during setup: `msiexec.exe /i /quiet /norestart` Then register from an administrator console: `te-agent --register ` {% hint style="info" %} For browser extension flags, Extended Network Tests, and other command-line options, see [Endpoint Agent Installation Reference for Windows](/product-documentation/global-vantage-points/endpoint-agents/installing/windows/endpoint-agent-installation-reference.md#command-line-options-for-msiexec). {% endhint %} 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](https://support.microsoft.com/en-gb/windows/windows-location-service-and-privacy-3a8eee0a-5b0b-dc07-eede-2a5ca1c49088). ![](/files/Adi9zXfp3Fhsn0IpuQiI) 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**: ![](/files/uYj1WPxJEDLD1sq8DEWa) You can uninstall the agent from **Add/Remove Programs** in **Control Panel** or **Apps & Features** in **Settings**: ![](/files/WaDzSJkMsBZIYKGkEBhc) For enterprise deployment at scale, see [Install Endpoint Agents for Windows via Group Policy](/product-documentation/global-vantage-points/endpoint-agents/installing/windows/install-endpoint-agent-for-windows-via-group-policy.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/installing/windows/install-the-endpoint-agent-on-windows.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.