Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Installing the Endpoint Agent on macOS

This article covers system requirements, downloading the installer, and installing the Endpoint Agent on macOS 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 macOS, you must have the following:

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

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 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

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.

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.

  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 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.

  3. Continue with 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.

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 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 or the Chrome extension section 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.

    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 <connection-string>

Silent Installation

  1. Download the installer containing the .pkg file.

  2. Install the package: installer -pkg <path_to_pkg> -target /

  3. Register the agent:

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

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.

The connection string is visible only to users in roles with the Download Endpoint Agents permission.

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.

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.

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:

You can uninstall the agent by dragging the application to Trash or right-clicking and selecting Move to Trash:

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.

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

After installation, the extension appears in Chrome under More Tools > Extensions:

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.

For enterprise deployment with Munki, see Install Endpoint Agents for macOS using Munki and the Managed Software Center.

PreviousmacOSNextInstall the Endpoint Agent Browser Extension on macOS

Last updated