--- title: "Using the debian file to manually upgrade agent software" slug: "using-the-debian-file-to-manually-upgrade-agent-software" updated: 2026-09-08T19:06:27Z published: 2026-09-08T19:06:27Z canonical: "docs.trellix.com/using-the-debian-file-to-manually-upgrade-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 upgrade agent software Use the compatible .deb file to manually upgrade agent software on your Linux endpoints running Ubuntu 14.04, 16.04, or 18.04. To manually upgrade 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 upgrade the agent software on your Linux endpoint. **You must have sudo access to run this command:** `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. For example, if your Linux endpoints are running Ubuntu 14.04, run `xagt-[xAgent version]-1.ubuntu12_amd64.deb`. If your Linux endpoints are running Ubuntu 16.04 or later, run `xagt-[xAgent version]-1.ubuntu16_amd64.deb`. 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. :