# Installing Enterprise Agent on VirtualBox {% hint style="warning" %} Due to recent platform-wide naming, navigation, and URL changes in the product, you may 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. Please bear with us as we update our screenshots to better match the in-product experience. 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 %} This article describes how to set up the ThousandEyes Enterprise Agent using the Virtual Appliance OVA with VirtualBox. To download, VirtualBox visit [https://www.virtualbox.org](https://www.virtualbox.org/). See the installation guides for VirtualBox: * Windows: Section 2.1 here: * Mac OS: Section 2.2 here: For your convenience, ThousandEyes provides an image of a virtual machine with the Enterprise Agent installed in OVA (Open Virtual Appliance) format, which is updated bi-weekly. Hence, we strongly recommend that you download a recent image for new Enterprise Agent installations. If your prefer more granular control of the your Enterprise Agent and the underlying operating system, we recommend you deploy the Enterprise Agent using the [Linux Package method](https://docs.thousandeyes.com/product-documentation/enterprise-agents/enterprise-agent-deployment-using-linux-package-method). ## Step-by-Step Guide To install the ThousandEyes Virtual Appliance, do the following: 1. To download the most recent [Enterprise Agent](https://docs.thousandeyes.com/product-documentation/enterprise-agents/what-is-an-enterprise-agent) image, begin by navigating to \*\*Network & App Synthetics > Agent Settings > Enterprise Agents ([thousandeyes-va-\.ova](https://app.thousandeyes.com/install/downloads/appliance/thousandeyes-appliance.ova)). 2. Click **Add New Enterprise Agent**. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-d8b87e6d6578e0ab5cf6e7b25710fcb3de1c94ce%2Fproduct-documentation_enterprise-agents_installing-enterprise-agent-on-virtualbox-1.png?alt=media\&token=091b4459-a008-4ca6-86b2-ad3755f1c239) 3. The **Add New Enterprise Agent** button reveals the installation options available for the Enterprise Agent. These instructions cover deployment using the OVA package. Select **Download - OVA** to get the latest version. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-f81c34caefe2a28e2869f729fb53b0e313f496bb%2Fproduct-documentation_enterprise-agents_installing-enterprise-agent-on-virtualbox-2.png?alt=media\&token=cfb7b410-aae7-40d8-8ada-a1cd2405f6a5) 4. Once the image is downloaded, open the VirtualBox application and click File > Import Appliance. The screenshot below is of VirtualBox version 5.2.20 r125813 (Qt5.6.3) on macOS Mojave. Depending on your operating system and version, what you see might have minor differences. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-704a862cb59e3398316a167d73561c4690dfccbc%2Fproduct-documentation_enterprise-agents_installing-enterprise-agent-on-virtualbox-3.png?alt=media\&token=d5c47cdc-6af0-49c0-b7fc-847e537adac4) 5. Click **Browse** and select the downloaded virtual appliance image. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-ca7b910079aa856b3f4e998ec54eebdb65bd1f99%2Fproduct-documentation_enterprise-agents_installing-enterprise-agent-on-virtualbox-4.png?alt=media\&token=942d75bf-e700-487b-aed1-d1e6c7b555a8) 6. Once the image is selected, click **Continue**. 7. The **Appliance settings** menu displays. Many options are preconfigured. However, the following options can be re-configured: * Name of the VM * CPU count * RAM * Hard disk space * Network interface The agent is designed to operate with the specifications listed in [Enterprise Agent Hardware Requirements](https://docs.thousandeyes.com/product-documentation/enterprise-agents/enterprise-agent-hardware-requirements). If you choose settings higher than the recommended specifications, there are no additional benefits to the performance of the Enterprise Agent. However, performance will be degraded if you choose settings *below* the recommendations. Once you've finished making changes, click **Import**. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-cfbf5e673f963703349d3f0658e09c812b14ba44%2Fproduct-documentation_enterprise-agents_installing-enterprise-agent-on-virtualbox-5.png?alt=media\&token=2c33eeda-f3c1-4664-8a63-b5cdf7fc736c) 8. Wait for the appliance to be imported and visible in the VirtualBox Manager window. Once the import is complete (8), double-click the new machine to start. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-0132a2ba062c5ba72ad8e179e1e2a5a4e73c510f%2Fproduct-documentation_enterprise-agents_installing-enterprise-agent-on-virtualbox-6.png?alt=media\&token=e0db8271-5fc3-41dc-9b97-d8fa51735703) 9. Once the machine boots up, a welcome screen displays the default values for the virtual appliance's IP address, username, and password. The virtual appliance's IP address is obtained via DHCP by default. If you are not using DHCP, you can configure a static IP by pressing **N** and following the interactive setup wizard. The available network configuration options are the following: * Hostname * IPv4/IPv6 * DNS To reset the virtual appliance password to the default value, press **R**. You can access the Web UI at [https://\](https://docs.thousandeyes.com/product-documentation/global-vantage-points/enterprise-agents/installing/appliances/installing-enterprise-agent-on-virtualbox). Access can be upgraded to HTTPS by following the steps mentioned [here](https://docs.thousandeyes.com/product-documentation/enterprise-agents/secure-access-to-thousandeyes-appliances). ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-594c109719ab13d2e743ab424ae1f5130b90cca3%2Fproduct-documentation_enterprise-agents_installing-enterprise-agent-on-virtualbox-7.png?alt=media\&token=ed454f80-96c3-4f13-9c44-ddb7f856924d) 10. To open the web UI, open a web browser and enter the URL displayed on the welcome screen. Once you are at the URL, enter the default username and password. Then click **Login**. You will be prompted to change the default password. Enter the current and new passwords, then click **Change Password**. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-1f2da9aef0048453d9ee7c5dbc2fdb8a79d4ed06%2Fproduct-documentation_enterprise-agents_installing-enterprise-agent-on-virtualbox-8.png?alt=media\&token=1ad252b7-bb5b-4534-a1d4-f8c28afbe8ac) 11. Obtain the account group token as guided [here](https://docs.thousandeyes.com/product-documentation/enterprise-agents/where-can-i-get-the-account-group-token). Navigate to the **Agent** tab in the web UI. Enter the account group token in the **Account Group Token** field; then click **Save Changes**. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-ae37635c3f3cce5d5670d49a3051b9cd4f929c06%2Fproduct-documentation_enterprise-agents_installing-enterprise-agent-on-virtualbox-9.png?alt=media\&token=00990859-13cc-49ea-a85b-e84cec39335f) 12. The browser is now redirected to the **Review** page. Click **Complete** to finish setup. ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-2cc24c3216253a3847a07e97e15c86bdf87db4f9%2Fproduct-documentation_enterprise-agents_installing-enterprise-agent-on-virtualbox-10.png?alt=media\&token=e3dbcb77-9642-4825-81a4-30873a67cb3d) 13. If the **Review** page shows all checks green as in the screenshot above, your Enterprise Agent is now ready to run tests. The newly added Enterprise Agent will appear in the Settings > Enterprise Agents window, as seen below: ![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-0cf662204dfb1c2a8ef14f695261b4f146c01032%2Fproduct-documentation_enterprise-agents_installing-enterprise-agent-on-virtualbox-11.png?alt=media\&token=6f3c4075-5d94-4990-8904-fa001db5762d) ## Basic Troubleshooting * If your VM displays just a black screen, virtualization might be disabled or not available. On windows, you can confirm this using [these instructions](https://www.shaileshjha.com/how-to-find-out-if-intel-vt-x-or-amd-v-virtualization-technology-is-supported-in-windows-10-windows-8-windows-vista-or-windows-7-machine/) * If the path visualization appears broken or incomplete, this might be due to NAT. For a detailed explanation of this case, see [this article](https://docs.thousandeyes.com/product-documentation/internet-and-wan-monitoring/path-visualization/virtual-machine-with-nat-breaks-path-visualization) ## Related Articles * [Obtaining SSH access to ThousandEyes Appliance from Mac/Linux](https://docs.thousandeyes.com/product-documentation/enterprise-agents/connecting-to-the-thousandeyes-virtual-appliance-using-ssh-mac-linux) and [Windows](https://docs.thousandeyes.com/product-documentation/enterprise-agents/connecting-to-the-thousandeyes-virtual-appliance-using-ssh-windows) * [Firewall Configuration for Enterprise Agents](https://docs.thousandeyes.com/product-documentation/enterprise-agents/firewall-configuration-for-enterprise-agents) * [Installing Enterprise Agents in Proxy Environment](https://docs.thousandeyes.com/product-documentation/enterprise-agents/installing-enterprise-agents-in-proxy-environments) * [Password Reset on the Virtual Appliance](https://docs.thousandeyes.com/product-documentation/enterprise-agents/password-reset-on-the-virtual-appliance) * [Unlocking the ThousandEyes Appliance](https://docs.thousandeyes.com/product-documentation/enterprise-agents/unlocking-the-thousandeyes-appliance)