--- title: "Using the Debian file to manually install agent software" slug: "using-the-debian-file-to-manually-install-agent-software" updated: 2026-09-08T19:06:27Z published: 2026-09-08T19:06:27Z canonical: "docs.trellix.com/using-the-debian-file-to-manually-install-agent-software" --- > ## 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. # Using the Debian file to manually install agent software Use the compatible .deb file to manually install agent software on your Linux endpoints running Ubuntu 18.04. To manually install the agent software on a single Linux endpoint using the `.deb` file: 1. Open a Terminal session on the Linux endpoint that has the agent installation `.tgz` package. `username@localhost:~$` 2. Use the `cd` command to change to the `Trellix` directory you created in step 6 of [Downloading a Linux agent installation package from the Web UI](/docs/downloading-a-linux-agent-installation-package-from-the-web-ui). `username@localhost:~$ cd desktop` `username@localhost:~/Desktop$ cd Trellix` 3. Use the `ls` command to verify that the `IMAGE_HX_AGENT_LINUX_[xAgent version].tgz` file is in the `Trellix` directory. `username@localhost:~/Desktop/Trellix$ ls` `IMAGE_HX_AGENT_LINUX_[xAgent version].tgz` 4. Use the `tar zxf` command to unzip and extract the files from the Linux agent installation package: `username@localhost:~/Desktop/Trellix$ tar zxf IMAGE_HX_AGENT_LINUX_[xAgent version].tgz.` The `.tgz` package (Linux) includes the following files: - Agent `.rpm` files - Agent `.deb` files - Agent configuration file (agent_config.json) 5. Use the `ls` command to view the files. `username@localhost:~/Desktop/Trellix$ ls` You will see a list of all the files in the agent installation package. 6. Use the `dpkg`, medium-level package manager for Debian and the -i option to run the `.deb` script and install the agent software on your Linux endpoint. **You must have sudo access to perform steps 6-8.** `username@localhost:~/Desktop/Trellix$ sudo dpkg -i xagt-[xAgent version]-1.ubuntu12_amd64.deb` ### Important Run the `.deb` file that is compatible with the supported Ubuntu version running on your Linux endpoints. The `.deb` file automatically detects the version of Ubuntu currently running on the endpoint. If the `.deb` file is not compatible with the Ubuntu version running on the endpoint, an error message appears. 7. After the `.deb` installation script is complete, use the `i` option to import the agent configuration file from the `/opt/fireeye/bin/xagt` binary path: `username@localhost:~/Desktop/Trellix$ sudo /opt/fireeye/bin/xagt -i agent_config.json` 8. Start the agent services on your Linux endpoint using the following command: `username@localhost:~/Desktop/Trellix$ sudo service xagt start` :