> 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/enterprise-agents/installing/linux-package-agent-installation.md). # Linux Package Agent Installation The ThousandEyes Enterprise Agent can be deployed on a variety of Linux distributions such as Ubuntu, Red Hat Enterprise Linux (RHEL), and CentOS. Supported operating systems can be found here: [Supported Enterprise Agent Operating Systems](https://docs.thousandeyes.com/product-documentation/global-vantage-points/enterprise-agents#supported-enterprise-agent-operating-systems). {% hint style="warning" %} Customers who choose to install the ThousandEyes Enterprise Agent onto their own Linux system using the **Linux Package** installation method are responsible for system maintenance. {% endhint %} For Linux distributions not on this list, you may be able to install [Docker](https://www.docker.com/) and the Enterprise Agent Docker container. For more details, see [Enterprise Agent deployment using Docker](https://docs.thousandeyes.com/product-documentation/enterprise-agents/enterprise-agent-deployment-using-docker). ## Installation {% hint style="warning" %} The ThousandEyes for Government instance has additional requirements for Linux package installations. Refer to the [ThousandEyes for Government - FedRAMP® Moderate](https://docs.thousandeyes.com/product-documentation/thousandeyes-for-government#linux-package) documentation for prerequisites and configuration requirements **before** continuing. {% endhint %} Log in to the Linux system on which you will install the ThousandEyes Enterprise Agent. Log in either as the root user, or a user which has been granted “sudo” access to the necessary package management and other commands required for the installation. Then log into the ThousandEyes application and follow the steps found under **Network & App Synthetics > Agent Settings > Enterprise Agents > +Add New Agent > Linux Package**, explained in detail below. The first step downloads the installation script from ThousandEyes: ``` curl -Os https://downloads.thousandeyes.com/agent/install_thousandeyes.sh ``` The second command enables execute permission for the installation script: ``` chmod +x install_thousandeyes.sh ``` The third command runs the script: ``` sudo ./install_thousandeyes.sh -b ``` **Notes** * The Account Group Installation Token identifies the Agent as belonging to a specific Account Group and can be found under **Network & App Synthetics > Agent Settings**. Click **+Add New Agent** and then **Show Account Group Token for Installation**. * If there are multiple Account Groups in your organization you will need to copy the token from the Account Group context in which you wish the Agent to be first seen. An Agent can be shared between groups. Additional information could be found here: [Working with Agent settings](https://docs.thousandeyes.com/product-documentation/thousandeyes-basics/working-with-agent-settings). * If multiple IP addresses are detected on the system, you will be prompted to choose the appropriate one during installation. ### Advanced Options To display the advanced options when installing the Agent use either -h or --help flags. ``` $ ./install_thousandeyes.sh --help Usage: ./install_thousandeyes.sh [-b [-L] [-W]] [-f] [-h] [-I INSTALL_LOG] [-l LOG_PATH] [-t PROXY_TYPE -P PROXY_LOCATION [-U PROXY_USER -u PROXY_PASS]] [-r REPO] [-s] [-v AGENT_VERSION] [-O] ACCOUNT_TOKEN -b Also install BrowserBot, an agent component that collects Page Load and Transaction test data using an instance of the Chromium browser -L Also install international language packages for BrowserBot (requires -b) -W Install BrowserBot without its recommended packages (e.g. te-xvfb) (requires -b) -f Force batch mode -h Print this message -I Set the install log location to INSTALL_LOG -l Set the log path to LOG_PATH -t Set the proxy type: DIRECT (default, no proxy), STATIC, or PAC -P Set the proxy location, format depends on PROXY_TYPE DIRECT PROXY_LOCATION is an invalid option for DIRECT STATIC host:port for hostname or IPv4 address [IPv6 IP]:port for IPv6 address PAC URL where PAC file can be found -U Set the proxy user to PROXY_USER -u Set the proxy password to PROXY_PASS -a Set the proxy authentication type: BASIC (default), NTLM -r Force the installer to install from REPO (overriding original ones) -s Skip the repository creation -v Specify agent version -O Install the agent, but do not start the agent services ``` ## Post-Installation Once the installation completes, the Agent will start automatically. Normally, within a minute the Agent will appear under **Network & App Synthetics > Agent Settings**. ![Enterprise Agents screen showing a newly installed agent](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-fa17e560fd8a4b09bc6b7e8f5b0fc286003a2a22%2Fproduct-documentation_enterprise-agents_enterprise-agent-deployment-using-linux-package-method-1.png?alt=media\&token=b36f5efb-a887-4743-a267-a926a926e05a) ### Managing the Enterprise Agent Service Use the following commands to check the Enterprise Agent service status or control the service: ``` $ sudo systemctl status te-agent $ sudo systemctl stop te-agent $ sudo systemctl start te-agent $ sudo systemctl restart te-agent ``` ### Configuring Time Synchronization Configure a time synchronization service on the Enterprise Agent host to avoid clock synchronization problems. For configuration guidance, including Chrony support, see [Troubleshooting Time Synchronization on Enterprise Agents](/product-documentation/global-vantage-points/enterprise-agents/troubleshooting/troubleshooting-time-synchronization-on-enterprise-agents.md).