--- title: "Installing the agent installation package" slug: "installing-the-agent-installation-package" updated: 2026-09-08T18:53:46Z published: 2026-09-08T19:06:36Z canonical: "docs.trellix.com/installing-the-agent-installation-package" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Installing the agent installation package You can deploy the agent installation package to your host endpoints the same way that your enterprise installs any other software. Trellix clients have successfully used a wide variety of software management utilities, such as BigFix and SCCM (in Windows environments), to deploy the agent software on their endpoints. See [Software management utility installation Notes](/docs/software-management-utility-installation-notes). ### Important Trellix recommends that you deploy your Endpoint Security (HX) server before deploying your agent software on your managed endpoints. Trellix recommends that you manually install the Endpoint Security Agent (HX) on a few host machines and test them according to your enterprise’s existing policies before you deploy the agent to all your host machines. Trellix also recommends that you test the Endpoint Security Agent (HX) on host endpoints with other third-party applications to ensure there are no performance or compatibility issues between the agent software and your third-party applications. ### Agent installation package for windows and macOS endpoints Trellix’s universal agent installation package is a `.zip` file (Windows) . The `.zip` file (Windows environments) and `.dmg` file (macOS environments) both contain the agent installation and the agent configuration file. The Windows installation file is a standard `.msi` file. The agent configuration file is an `agent_config.json` file that specifies server settings for the agent. Generally, both files must be in the same folder on any machines on which you want to install the agent. However, you can use the [CONFJSONDIR installation option](/docs/specifying-an-alternate-configuration-file-location-1) to specify an alternate location for the configuration file. ### Agent installation package for Linux endpoints The `.tgz` file (Linux environment) includes the RedHat Package Manager (.rpm) and Debian package (.deb) install packages, and the agent configuration file (`agent_config.json`). The following table lists the specific agent installation file required to install the agent software on each supported Linux operating system version and the supported deployment scenario for each installation file. | File Type | Agent Software Installation File | Compatible Linux OS Versions | Deployment | | --- | --- | --- | --- | | `.rpm` | `xagt-[xAgent version]-1.el7.x86_64.rpm` | - RHEL 7.2 and above - Amazon Linux 2, Amazon Linux 2023, AMI2 and AMI 2018.3 - Oracle 7.7 and above | Single or Bulk | | `xagt-[xAgent version]-1.sle12.x86_64.rpm` | - SUSE Enterprise Linux Server 12.4 and above - OpenSUSE Leap 15.1 and above | Single or Bulk | | `.deb` | `xagt-[xAgent version]-1.ubuntu16_amd64.deb` | - Ubuntu 18.04 LTS and above | Single or Bulk | | Single or Bulk | This section covers the following topics: - [Downloading an agent installation package from the Web UI](/docs/downloading-an-agent-installation-package-from-the-web-ui) - [HTTPS proxy server overview and configuration](/docs/https-proxy-server-overview-and-configuration-2) - [Software management utility installation notes](/docs/software-management-utility-installation-notes) - [Windows agent installation and uninstallation options](/docs/windows-agent-installation-and-uninstallation-options) - [Manually installing agent software](/docs/manually-installing-agent-software) - [Installing agents using a golden or master image](/docs/installing-agents-using-a-golden-or-master-image) :