--- title: "Custom source location" slug: "custom-source-location" updated: 2026-08-28T06:17:03Z published: 2026-09-08T19:11:50Z canonical: "docs.trellix.com/custom-source-location" --- > ## 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. # Custom source location By default, malware definitions are downloaded from the Internet. In xAgent 36 and higher, you can configure a custom download channel for deploying malware definition updates to your host endpoints (a custom source). The custom source can also be communicated with via proxy server. For general instructions on how to configure a proxy server, see [HTTPS Proxy Server Overview and Configuration](/docs/filepaligotmpfireeye62db1f1da4573agentag350contenttopicsconfigurationproxy20serverconfiguring20an20https20proxy20server20connectionhtm). The instructions on this page demonstrate how to set up a custom content server using Ubuntu 19.04, and how to enable it in the Endpoint Security (HX) server WebUI. ### Important Custom content server setup instructions may vary, depending on your particular environment. You are responsible for setting up your own custom content server. Trellix cannot provide instructions or customer support for setting up a custom content server. ### Note The following example steps were executed on an Ubuntu 19.04 server OS. - [Configuring the Custom Download Channel](/docs/configuring-the-custom-download-channel) ### Step 1 - Set Up the Content Web Server ### Important The following steps require root level privileges. ### Note Remove any default HTML pages. The web server must contain only content. ### Note A proxy environment for the content web server requires a forward proxy server. A reverse proxy server will not work (at all), or may cause problems over proxy. **To set up the content web server:** 1. Install Apache 2 on an Ubuntu machine: ``` sudo apt-get update ``` ``` sudo apt-get install apache2 ``` 2. Create a web server configuration file (such as `mycustomsite.com.conf`) in `/etc/apache2/sites-available`. 3. Create a top level web server folder (such as `/var/www/mycustomsite.com/`). Set server permissions to 705. 4. Add a server-specific directory configuration under `/etc/apache2/apache2.conf`, and grant required permissions. 5. Make sure the Indexes and MultiViews are forbidden for all the directories in the configuration file to prevent access via browser. 6. Add the web server domain entry to your DNS records, so it can be accessed by all host endpoints. 7. Enable the `mycustomsite.com.conf` configuration file and make sure no error occurs. ### Note Trellix recommends using a static IP address for the custom server. ### Note To check if the content update is ocurring via proxy or directly over the web server, use `UpdateSampleC.exe` in the Updater SDK. Follow the subsequent help instructions to verify that the content is downloading. ### Step 2 - Set Up the Bitdefender Mirroring Application ### Important The following steps should be completed while using root level privileges. ### Important Bitdefender must already be installed on your endpoints before this setup procedure. **To set up the Bitdefender mirroring application:** 1. Install PHP. 2. Create the `/usr/local/bitdefender/` directory, and copy the `mirror.cnf` configuration file from the provided `template.zip` file to that directory. 3. Update the `mirror.cnf` file in `/usr/local/bitdefender/mirroring/php` with required configurations. - Set `WWW_VERSIONDIR` to the top level within the web server folder. - Specify the number of versions to store in `VERSIONHISTORY`. - `MIRRORPATCHES` should be set to 1 to allow mirroring of update patches. 4. Run the `update.php` script with `mirror.cnf` as an argument: `php update.php mirror.cnf` - `WWW_DIR` is the folder path to download 32-bit Bitdefender content, and it must point to the top level within the web server folder. The directory name must be "av32bit" for this feature. - `WWW_DIR64` is the folder path to download 64-bit Bitdefender content, and it must point to the top level within the web server folder. The directory name must be "av64bit" for this feature. 5. Add a `cron` job to execute the `update.php` script every 20 minutes, so that the web server content is up-to-date. Since the update script requires the `providers.conf` file to be present in the same directory, Trellix recommends running the `cron` job using a script. A template of the `cron` job is in the provided `template.zip` file. ### Note Bitdefender downloads only the delta content in every update. ### Important If content download from the Bitdefender main server occurs over a proxy, then proxy authentication is required. ### Important Enable any other options required by your environment. ### Step 3 - Test the Bitdefender Mirror Server Test the custom server configuration to verify that the content is successfully downloaded from the web server that you set up in [Step 1 - Set up Content Web Server](/docs/custom-source-location#UUID-9a4ba845-d677-e430-9bc2-70c8391495e9_id_contentwebserver). This test also ensures that correct folder permissions are set on the web server directory, so that the Agent software can fetch the web server content. **To test the Bitdefender mirror server:** 1. Switch to a non-owner user of the mirroring folder. 2. Run the command: ``` php /path/to/update.php -u -d ``` ### Important This test directory must be a valid directory for the command to execute successfully. **Sample test output:** ![mirror-test.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-4f4c7785-c06c-12bd-30bc-a62938368f79(1).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A02%3A20Z&se=2026-11-22T14%3A02%3A20Z&sr=c&sp=r&sig=2WDRjougsg1hisdClIZP%2BhUgawBSO%2BdRk%2BQURJ7ysvQ%3D) ### Note After this test, if the data from testing the mirror server is no longer needed, Trellix recommends deleting the test folder, to preserve server storage. :