# Install the Endpoint Agent

This article describes how to install the Endpoint Agent on the various supported operating systems.

To install the Endpoint Agent, run the graphical installer (for download instructions, see [Download the Endpoint Agent](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/installing/download-the-installer)). The installer requires the user to agree to the software license to proceed with the installation.

## Installation on Windows

The Windows installer package (MSI) installs all the components necessary for the Endpoint Agent to function. The Windows MSI installer, like any other Windows software package, can be invoked interactively by a user who has administrative privileges on the target machine.

The installation can be done in either of the following ways:

#### Interactive Installation

You can install the Endpoint Agent interactively by following these instructions:

1. Launch the installer from the location on your machine.
2. Accept the terms of the license agreement in the installation wizard and click the **Next** button.
3. Follow the instructions in the installation wizard and continue to the next steps.
4. You can provide the [Connection String](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/installing/endpoint-agent-installation-reference#connection-string) to register the agent with the correct account group in the ThousandEyes platform.

   ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-4b839c10abdf6542c77624754307140fcd9cdad8%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_install_the_agent-1.png?alt=media\&token=8ce00d8d-b3e2-41ff-ac08-e4b36b8698e1)

   Alternatively, you can skip entering the connection string and run the following command after the installation to register the agent with the desired account group:

   `te-agent --register <connection_string>`

   You need to run the registration command from the administrator console on Windows.

{% hint style="info" %}
For information on additional configuration options, including browser extension installation and Extended Network Tests support, see [Endpoint Agent Installation Reference](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/installing/endpoint-agent-installation-reference) before continuing.

Do not install the Google Chrome and Microsoft Edge browser extensions via the installer as it might conflict with the existing [Group Policy settings](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/installing/install-endpoint-agent-for-windows-via-group-policy).

If you are using Group Policy to manage browser extensions for organization-distributed add-ins, do not select the **Browser Extension** option during the Endpoint Agent installation and instead add the browser extension separately.

You can refer to the [Install the Endpoint Agent Browser Extension](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/installing/install-the-browser-extension) article for alternate methods to install the browser extension.
{% endhint %}

5. Upon successful installation, the Endpoint Agent doesn’t create any entries under the **Applications Menu**. All the Endpoint Agent products are installed at: `C:\Program Files (x86)\ThousandEyes\`

#### Silent Installation

You can install the Endpoint Agent silently, or schedule silent installation as part of an installation script. In such cases, use the following instructions via the command line:

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

Here the [Connection String](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/installing/endpoint-agent-installation-reference#connection-string) parameter determines the account group with which the agent needs to be registered.

For example, the following command will install the Endpoint Agent via the MSI located at **C:\Endpoint Agent-x86-1.2.0.msi** and will save the installation output to the file **C:\ThousandEyesInstall.log**:

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

Alternatively, you can install the agent using the following command:

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

Subsequently, you need to run the following command to register the agent with the desired account group:

`te-agent --register <connection_string>`

You need to run the registration command from the administrator console on Windows.

{% hint style="info" %}
For information on additional configuration options, including browser extension installation and TCP support, see [Endpoint Agent Installation Reference](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/installing/endpoint-agent-installation-reference#windows-command-line) before continuing.
{% endhint %}

The Endpoint Agent does not require a machine restart upon installation. But there may be a case where Windows OS requires a reboot, and this can be part of your company’s internal IT policy too. ThousandEyes recommends you use the **/norestart flag** in the installation command line. If the silent installation fails, the output log file will contain the necessary information to pinpoint the root cause of the failure.

{% hint style="info" %}
**Endpoint Agent Wi-Fi Reporting on Windows 11 (24H2) and Later**

To align with Microsoft's guidelines for the Windows operating system, ThousandEyes recommends enabling location services to accurately report the SSID or BSSID information of the currently connected Wi-Fi access point.

To enable the **Location Services**:

1. Navigae to \*\*Privacy & security \*\* section in your system settings.
2. Expand the **Location** tab and toggle on the **Location services**. You can learn more about this setting [here](https://support.microsoft.com/en-gb/windows/windows-location-service-and-privacy-3a8eee0a-5b0b-dc07-eede-2a5ca1c49088).

<img src="https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-0f5ad971288ab3576b9dcdbf5bf18e12a5b73df8%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_install-the-endpoint-agent-11.png?alt=media" alt="" data-size="original">

If you choose not to enable the services mentioned above, the ThousandEyes UI will display a fixed value in the format **Unknown SSID—Agent Name / Unknown BSSID—Agent Name**.
{% endhint %}

### Verifying Your Installation

Upon successful installation, all the installed files can be seen in the folder - **C:\Program Files (x86)\ThousandEyes\Endpoint Agent**

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-e51a633c7a2c04325c7a1f8794b662d57482070c%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_install-the-endpoint-agent-7.png?alt=media\&token=b4686ce9-d20b-44c8-ba1e-69de1ddc921c)

The Endpoint Agent can be uninstalled from the **Add/Remove Programs** in the **Control Panel** or **Apps & Features** interface in the **Setings**:

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-e4694fe62ed576c61e429817516e0147ef078768%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_install-the-endpoint-agent-8.png?alt=media\&token=69ee1009-7629-479c-ba31-5897d7c62774)

## Installation on MacOS

The macOS installer (**.pkg** file) installs all the components necessary for the Endpoint Agent to function except the Chrome extension (for details see [**Chrome Extension**](#adding-the-thousandeyes-chrome-extension)). The macOS **.pkg** installer, like any other macOS software package, the macOS **.pkg** installer can be invoked interactively by a user with administrator privileges on the target machine.

Following is an example of the downloaded installer file name:

* `Endpoint Agent-x64-1.190.0.pkg`
* `Endpoint Agent Pulse-x64-1.190.0.pkg`

The installation can be done in either of the following ways:

#### Interactive Installation

You can install the Endpoint Agent interactively by following these instructions:

1. Download the installer package. It will download all the necessary components.
2. Double-click (open) the **.pkg** file on the target machine.
3. Follow the instructions on the installation wizard to complete the installation.
4. Post successful installation, you can provide the [Connection String](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/installing/endpoint-agent-installation-reference#connection-string) in the **Account Configuration** dialog box to register the agent with the correct account group in the ThousandEyes platform.

   ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-33749941145cd8e2e12e25b89d0d996bfc6946a7%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_install_the_agent-11b.png?alt=media\&token=e24dc978-6f89-40b6-9098-68ff0cb68218)

Alternatively, you can skip entering the connection string in the the **Account Configuration** dialog box and on the command line with administrative privileges (`sudo`), run the following command with the [Connection String](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/installing/endpoint-agent-installation-reference#connection-string) to register the agent with the desired account group:

`sudo /Applications/ThousandEyes\ Endpoint\ Agent.app/Contents/MacOS/te-agent --register <connection-string>`

#### Silent Installation

You can install the Endpoint Agent silently, or schedule silent installation as part of an installation script. In such cases, use the following instructions:

1. Download the installer. It contains the **.pkg** file and the necessary components.
2. Install the **.pkg**: `installer -pkg <path_to_pkg> -target /`
3. Execute: `/Applications/ThousandEyes\ Endpoint\ Agent.app/Contents/MacOS/te-agent --register <connection-string>`

   Here the [Connection String](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/installing/endpoint-agent-installation-reference#connection-string) parameter determines the account group with which the agent needs to be registered.

If the silent installation fails, the output log file will contain the necessary information to pinpoint the root cause of the failure. The system manages the installation output log file, which is **/var/log/install.log**.

### Enabling Location Services for Endpoint Agent Wi-Fi Reporting

{% hint style="info" %}
To report the SSID or BSSID information for the currently connected Wi-Fi access point accurately, the Endpoint Agent needs Location Services to be enabled, as well as the option to share location data for the ThousandEyes Endpoint Agent application.
{% endhint %}

After installing the Endpoint Agent, click the "Allow" button on the pop-up to enable the location services.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-d099702b4ccb97bf657e5d75edcd1f1f8d137b68%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_install-the-endpoint-agent-9.png?alt=media)

Alternatively, you can enable the services by:

1. Navigating to **System Settings > Privacy & Security > Location Services** in your device.
2. Toggle on the **Location Services** option.
3. In the following list of applications, toggle on the **ThousandEyes Endpoint Agent** option.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-12f04c78a5e99e0247484cb29f066e47d6c8264a%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_install-the-endpoint-agent-10.png?alt=media)

If you choose not to enable the above-mentioned services, the ThousandEyes UI will display a fixed value in the format **Unknown SSID—Agent Name / Unknown BSSID—Agent Name**.

### Verifying Your Installation

Upon successful installation, the Endpoint Agent appears in the system’s **Applications** folder:

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-f878256628ae6af9c6f559666b2826fbe8163b9f%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_install-the-endpoint-agent-1.png?alt=media\&token=5704c0bc-93da-4cab-8174-b4ebe4a229d6)

The Endpoint Agent can be uninstalled by either dragging and dropping the application icon into the **Trash** or by right-clicking the icon and selecting **Move to Trash**:

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-4fa6f27659ff0b9d3aed51c4fc391f081039356b%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_install-the-endpoint-agent-2.png?alt=media\&token=53a7b18a-3ab4-42d9-bc80-04a5185ffbe7)

### Adding the ThousandEyes Chrome Extension

If you used the **.pkg** installer interactively, when the installation completes, Chrome opens and displays the [ThousandEyes browser extension in the Chrome Web Store](https://app.thousandeyes.com/install/endpoint-agent).

To install the extension to your Chrome profile, click the **Add to Chrome** button:

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-497ddc0a090227be22e1cdf64379fb44b578aa74%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_install-the-endpoint-agent-3.png?alt=media\&token=a76c201c-d37f-4cd2-a443-74ee2b87ad20)

### Verifying Your Installation

After installation, the extension will be visible in Chrome’s extension page under **More Tools” > “Extensions**:

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-b09476d819b0a1366f52d0b56b45687f3a9fef62%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_install-the-endpoint-agent-4.png?alt=media\&token=05c5d515-9465-4aef-826f-dc3ab5d74585)

If all the components are installed correctly and are running on the target machine, the Chrome extension will appear on the Chrome browser toolbar:

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-cc73f0bea45c8d9a30208f3120e7066074f4e2d0%2Fproduct-documentation_global-vantage-points_endpoint-agents_installing_install-the-endpoint-agent-5.png?alt=media\&token=afce7fb4-4e19-452c-9c65-fa3475871fbe)

However, if the Endpoint Agent is not installed or if there’s a problem in any of its components, the extension’s icon will appear grayed-out.

### Updating the Chrome Extension

The ThousandEyes Chrome extension needs to be installed only once when you install the Endpoint Agent on the target machine for the first time. After the initial installation, the extension will be automatically updated whenever a new extension is published in the Chrome Web Store.

{% hint style="info" %}
It can take up to four hours for the ThousandEyes Chrome extension to automatically update from the time it was published.
{% endhint %}

Alternatively, you can set up automatic installation of the Chrome extension on users' computers. This can be done by following the [instructions recommended by Google](https://support.google.com/chrome/a/answer/7517624?hl=en). If you use this automated method, use the following as the extension's ID: `ddnennmeinlkhkmajmmfaojcnpddnpgb`