> 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/macos/install-the-endpoint-agent-on-macos.md). # Installing the Endpoint Agent on macOS This article covers system requirements, downloading the installer, and installing the Endpoint Agent on macOS 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 macOS, 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 on macOS. {% endhint %} ### Supported Operating Systems The Endpoint Agent is compatible with the three most recent major macOS versions. For example, if the latest macOS version is macOS 15 Sequoia, Endpoint Agent is supported on macOS 13 Ventura and newer. For macOS machines that use ARM architecture, use **Endpoint Agent-arm64-1.210.4.pkg** and future ARM releases. ### Supported Browsers The following web browser is certified for operation with the Endpoint Agent browser extension on macOS: * Chrome 41+ ### 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. ### 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 macOS: 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 **macOS** to download the `.pkg` 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. Example installer file names: * `Endpoint Agent-x64-1.190.0.pkg` * `Endpoint Agent Pulse-x64-1.190.0.pkg` * `Endpoint Agent-arm64-1.210.4.pkg` (Apple Silicon) ### 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 macOS and select **Copy Link Address**. 4. Share this address along with the corresponding [Connection String](#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 macOS installer (`.pkg` file) installs all components necessary for the Endpoint Agent to function except the Chrome extension. For Chrome extension setup, see [Install the Endpoint Agent Browser Extension on macOS](/product-documentation/global-vantage-points/endpoint-agents/installing/macos/install-the-browser-extension.md) or the [Chrome extension section](#adding-the-thousandeyes-chrome-extension) below. The `.pkg` installer can be invoked interactively by a user with administrator privileges, or silently from the command line. ### Interactive Installation 1. Download the installer package. 2. Double-click (open) the `.pkg` file on the target machine. 3. Follow the instructions in the installation wizard. 4. After successful installation, provide the connection string in the **Account Configuration** dialog box to register the agent with the correct account group. ![](/files/yd08NyVx3h72JooA9IVM) Alternatively, skip entering the connection string and run the following command with administrative privileges (`sudo`): `sudo /Applications/ThousandEyes\ Endpoint\ Agent.app/Contents/MacOS/te-agent --register ` ### Silent Installation 1. Download the installer containing the `.pkg` file. 2. Install the package: `installer -pkg -target /` 3. Register the agent: `/Applications/ThousandEyes\ Endpoint\ Agent.app/Contents/MacOS/te-agent --register ` If silent installation fails, check **/var/log/install.log** for details. ### Connection String The connection string identifies the account group where the agent registers. Access it in the ThousandEyes web application at **Endpoint Experience > Agent Settings > Add New Endpoint Agent**. {% hint style="warning" %} The connection string is visible only to users in roles with the **Download Endpoint Agents** permission. {% endhint %} ![](/files/OcOZ09wecNts4A1VuPfH) ### Enable Location Services for Wi-Fi Reporting To report SSID or BSSID information for the connected Wi-Fi access point accurately, enable Location Services and allow location data for the ThousandEyes Endpoint Agent application. After installing the Endpoint Agent, click **Allow** on the location services pop-up. ![](/files/l14XeGKo4QuntfrG4oq3) Alternatively: 1. Navigate to **System Settings > Privacy & Security > Location Services**. 2. Toggle on **Location Services**. 3. Toggle on **ThousandEyes Endpoint Agent** in the application list. ![](/files/9go58IOqXwxYOdhzLuxt) 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, the Endpoint Agent appears in the **Applications** folder: ![](/files/5wpswxcxioOIPNHcrsLM) You can uninstall the agent by dragging the application to **Trash** or right-clicking and selecting **Move to Trash**: ![](/files/Fwer7SaKcvvTqxFpOhX3) ### Adding the ThousandEyes Chrome Extension If you used the `.pkg` installer interactively, when installation completes, Chrome might open 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 **Add to Chrome**: ![](/files/u81MC53O53sz1fcEN1Pp) After installation, the extension appears in Chrome under **More Tools > Extensions**: ![](/files/u44ovJo6jEb7aGAd6TIj) If all components are installed and running, the Chrome extension icon appears in the browser toolbar. If the Endpoint Agent is not installed or a component has a problem, the icon appears grayed out. For additional Chrome extension guidance, see [Install the Endpoint Agent Browser Extension on macOS](/product-documentation/global-vantage-points/endpoint-agents/installing/macos/install-the-browser-extension.md). For enterprise deployment with Munki, see [Install Endpoint Agents for macOS using Munki and the Managed Software Center](/product-documentation/global-vantage-points/endpoint-agents/installing/macos/install-endpoint-agent-for-mac-munki-deployment.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/macos/install-the-endpoint-agent-on-macos.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.