--- title: "proxy server Section Settings" slug: "proxy-server-section-settings-1" updated: 2026-09-08T19:19:55Z published: 2026-09-08T19:19:55Z canonical: "docs.trellix.com/proxy-server-section-settings-1" --- > ## 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. # proxy server Section Settings [Skip to main content](/docs/proxy-server-section-settings-1#content-wrapper) Use the proxy server settings to set up a HTTPS proxy server that allows endpoints on your network to access the Endpoint Security (HX) server or Internet. | Setting Key | Default | Supported Edit Methods | | --- | --- | --- | | Web UI | CLI | API | | [type](/docs/proxy-server-section-settings-1#UUID-999507ac-4c60-f7b4-c4f3-b29fcd40520b) | `none` | Yes | Yes | Yes | | [host](/docs/proxy-server-section-settings-1#UUID-0ea2edb7-95ae-267d-f405-057c40900f91) | --- | Yes | Yes | Yes | | [port](/docs/proxy-server-section-settings-1#UUID-246cb84b-7965-d5cc-72da-3b0e55934fa7) | `80` | Yes | Yes | Yes | | [exclude_hosts](/docs/proxy-server-section-settings-1#UUID-ae3fca47-bb60-deab-2488-51412b64a523) | ` ["eng.fireeye.com", "host.fireeye.com"]` | Yes | Yes | Yes | | [exclude_local_hosts](/docs/proxy-server-section-settings-1#UUID-801447da-3edf-8ad7-3429-d470aa11f3c7) | `false` | Yes | Yes | Yes | | [username](/docs/proxy-server-section-settings-1#UUID-d508f7c5-b82c-0cd6-7b5a-564df069f746) | --- | Yes | Yes | Yes | | [password](/docs/proxy-server-section-settings-1#UUID-60e4d34c-9b2d-b689-8142-72dc4d82976f) | --- | Yes | Yes | Yes | | failed_retry_delay | | Yes | Yes | Yes | The proxy server settings must be enclosed in braces and listed within quotation marks ("). See the example below. `{` `"proxy": {` `"type": "manual",` `"host": "proxy.fireeye.com",` `"port": 80,` `"exclude_hosts": ["eng.fireeye.com", "host.fireeye.com"],` `"exclude_local_hosts": true,` `"username": "<proxy-user>",` `"password": "<proxy-user-password>"` `}` ##### proxy type Key The proxy `type` key controls the type of proxy server your endpoint uses. Options include `none`, `system`, and `manual`. The default value is `none`. The table below defines each proxy type. | Type Value | Description | | --- | --- | | `none` | No proxy server. Proxy switch is disabled. | | `system` | Configure your local system as a proxy server. See Configuring a Proxy Server Policy for the Default Policy. Host containment works only at the IP protocol layer. If your host endpointsuse a proxy server that has been added to the containment whitelist, a contained host will still be able to send and receive Web traffic and other traffic. If you are using an agent proxy and you want to be able to contain compromised hosts, you must set up the proxy server with a separate IP address that can only be used to reach the Endpoint Security (HX) server. Use the Endpoint Security (HX) xAgent Web UI to add the proxy server IP address to the Allowed IP Addresses on the **Containment Settings** page. See the *Endpoint Security User Guide* for more information. | | `manual` | Manually configure a remote system as your proxy server. See Configuring a Proxy Server Policy for the Default Policy. ### Note When the proxy `type` is set to `manual`, the proxy `server` setting is required or your proxy server connection will fail. The proxy `server` setting has no default value. | Change this setting using one of the following methods: - Web UI (See [Configuring an HTTPS Proxy Server Using the Web UI](/docs/configuring-a-proxy-server-policy-for-the-default-policy-1)). - API custom configuration channels (see [Using API Custom Configuration Channels](/docs/using-api-custom-configuration-channels-1)). - Manually on individual endpoints using a text editor (see [Modifying the Configuration File for a Single Endpoint](/docs/modifying-the-configuration-file-for-a-single-endpoint-1)). For manual changes, the proxy `type` key should be listed within quotation marks ("). Enclose the full list of proxy server settings in bracket ({}). For example, you can set the host value to `"type": "manual",`. `{` `"proxy": {` `"type": "manual",` `"host": "proxy.fireeye.com",` `"port": 80,` `"exclude_hosts": ["eng.fireeye.com", "host.fireeye.com"],` `"exclude_local_hosts": true,` `"username": "<proxy-user>",` `"password": "<proxy-user-password>"` `}` ##### proxy host Key The proxy `host` key defines the hostname for your HTTPS proxy server. There is no default `host`. ### Important If the proxy type is set to manual, you are required to set the proxy `host` key or your proxy server connection will fail. If you define the proxy `host`, you must also define the following: - [proxy type Key](/docs/proxy-server-section-settings-1#UUID-999507ac-4c60-f7b4-c4f3-b29fcd40520b) - proxy host Key Change this setting using one of the following methods: - Web UI (See [Configuring an HTTPS Proxy Server Using the Web UI](/docs/configuring-a-proxy-server-policy-for-the-default-policy-1)). - API custom configuration channels (see [Using API Custom Configuration Channels](/docs/using-api-custom-configuration-channels-1)). - Manually on individual endpoints using a text editor (see [Modifying the Configuration File for a Single Endpoint](/docs/modifying-the-configuration-file-for-a-single-endpoint-1)). For manual changes, the proxy `host` key should be listed within quotation marks ("). Enclose the full list of proxy server settings in bracket ({}). For example, you can set the host value to `"host": "proxy.fireeye.com",`. `{` `"proxy": {` `"type": "manual",` `"host": "proxy.fireeye.com",` `}` ##### proxy port Key The proxy `port` key defines your HTTPS proxy server TCP port number. The default port number is `80`. If you define the proxy `port` key, you must also define the following: - [proxy type Key](/docs/proxy-server-section-settings-1#UUID-999507ac-4c60-f7b4-c4f3-b29fcd40520b) - proxy port Key Change this setting using one of the following methods: - Web UI (See [Configuring an HTTPS Proxy Server Using the Web UI](/docs/configuring-a-proxy-server-policy-for-the-default-policy-1)). - API custom configuration channels (see [Using API Custom Configuration Channels](/docs/using-api-custom-configuration-channels-1)). - Manually on individual endpoints using a text editor (see [Modifying the Configuration File for a Single Endpoint](/docs/modifying-the-configuration-file-for-a-single-endpoint-1)). For manual changes, enclose the full list of proxy server settings in braces ({}). For example, you can set the `port` value to `"port": 80,`. `{` `"proxy": {` `"type": "manual",` `"host": "proxy.fireeye.com",` `"port": 80,` `}` ##### proxy exclude_hosts Key The proxy `exclude_hosts` key defines a list of hosts that should be excluded from proxy support. There is no default. If you define an `exclude_hosts` list for your proxy server, you must also define the following: - [proxy type Key](/docs/proxy-server-section-settings-1#UUID-999507ac-4c60-f7b4-c4f3-b29fcd40520b) - proxy exclude_hosts Key - [proxy port Key](/docs/proxy-server-section-settings-1#UUID-246cb84b-7965-d5cc-72da-3b0e55934fa7) Change the `exclude_hosts` key using one of the following methods: - Web UI (See [Configuring an HTTPS Proxy Server Using the Web UI](/docs/configuring-a-proxy-server-policy-for-the-default-policy-1)). - API custom configuration channels (see [Using API Custom Configuration Channels](/docs/using-api-custom-configuration-channels-1)). - Manually on individual endpoints using a text editor (see [Modifying the Configuration File for a Single Endpoint](/docs/modifying-the-configuration-file-for-a-single-endpoint-1)). For manual changes, The proxy `exclude_hosts` setting should be listed within quotation marks ("). Enclose the full list of proxy server settings in braces ({}). For example, you can add `"exclude_hosts": "eng.fireeye.com", "host.fireeye.com"`to the `exclude_hosts` list. `{` `"proxy": {` `"type": "manual",` `"host": "proxy.fireeye.com",` `"port": 80,` `"exclude_hosts": ["eng.fireeye.com", "host.fireeye.com"],` `}` ##### exclude_local_hosts Key The proxy `exclude_local_hosts` key indicates whether or not Trellix Endpoint Security (HX) xAgents should use the HTTPS proxy server when contacting host machines with local or simple hostnames. Valid values include `true` (enabled) and `false` (disabled). The default value is `false`. When you enable the `exclude_local_hosts` key, your HTTPS proxy server is not used to contact hosts with local or simple hostnames. When you disable the `exclude_local_hosts` key, your HTTPS proxy server is used to contact hosts with local or simple hostnames. If you disable the `exclude_local_hosts` key, you must also define the following: - [proxy type Key](/docs/proxy-server-section-settings-1#UUID-999507ac-4c60-f7b4-c4f3-b29fcd40520b) - exclude_local_hosts Key - [proxy port Key](/docs/proxy-server-section-settings-1#UUID-246cb84b-7965-d5cc-72da-3b0e55934fa7) Change this key using one of the following methods: - Web UI (See [Configuring an HTTPS Proxy Server Using the Web UI](/docs/configuring-a-proxy-server-policy-for-the-default-policy-1)). - API custom configuration channels (see [Using API Custom Configuration Channels](/docs/using-api-custom-configuration-channels-1)). - Manually on individual endpoints using a text editor (see [Modifying the Configuration File for a Single Endpoint](/docs/modifying-the-configuration-file-for-a-single-endpoint-1)). For manual changes, the proxy `password` setting should be listed within quotation marks ("). Enclose the full list of proxy server settings in braces ({}). `{` `"proxy": {` `"type": "manual",` `"host": "proxy.fireeye.com",` `"port": 80,` `"exclude_hosts": ["eng.fireeye.com", "host.fireeye.com"],` `"exclude_local_hosts": true,` `}` ##### proxy username Key The proxy `username` key allows you to authenticate access to your HTTPS proxy server. There is no default value. ### Note If you do not set a proxy username and password, proxy authentication is ignored. If you define a `username` for your proxy server, you must also define the following: - [proxy type Key](/docs/proxy-server-section-settings-1#UUID-999507ac-4c60-f7b4-c4f3-b29fcd40520b) - [proxy username Key](/docs/proxy-server-section-settings-1#UUID-d508f7c5-b82c-0cd6-7b5a-564df069f746) - [proxy port Key](/docs/proxy-server-section-settings-1#UUID-246cb84b-7965-d5cc-72da-3b0e55934fa7) - [proxy password Key](/docs/proxy-server-section-settings-1#UUID-60e4d34c-9b2d-b689-8142-72dc4d82976f) Change this setting using one of the following methods: - Web UI (See [Configuring an HTTPS Proxy Server Using the Web UI](/docs/configuring-a-proxy-server-policy-for-the-default-policy-1)). - API custom configuration channels (see [Using API Custom Configuration Channels](/docs/using-api-custom-configuration-channels-1)). - Manually on individual endpoints using a text editor (see [Modifying the Configuration File for a Single Endpoint](/docs/modifying-the-configuration-file-for-a-single-endpoint-1)). For manual changes, the proxy `username` setting should be listed within quotation marks ("). Enclose the full list of proxy server settings in braces ({}). `{` `"proxy": {` `"type": "manual",` `"host": "proxy.fireeye.com",` `"port": 80,` `"exclude_hosts": ["eng.fireeye.com", "host.fireeye.com"],` `"exclude_local_hosts": true,` `"username": "<proxy-user>",` `"password": "<proxy-user-password>"` `}` ##### proxy password Key The proxy `password` allows you to authenticate access to the proxy server. There is no default value. ### Note If you do not set a proxy username and password, proxy authentication is ignored. If you define a `password` for your proxy server, you must also define the following: - [proxy type Key](/docs/proxy-server-section-settings-1#UUID-999507ac-4c60-f7b4-c4f3-b29fcd40520b) - [proxy password Key](/docs/proxy-server-section-settings-1#UUID-60e4d34c-9b2d-b689-8142-72dc4d82976f) - [proxy port Key](/docs/proxy-server-section-settings-1#UUID-246cb84b-7965-d5cc-72da-3b0e55934fa7) - [proxy username Key](/docs/proxy-server-section-settings-1#UUID-d508f7c5-b82c-0cd6-7b5a-564df069f746) Change this setting using one of the following methods: - Web UI (See [Configuring an HTTPS Proxy Server Using the Web UI](/docs/configuring-a-proxy-server-policy-for-the-default-policy-1)). - API custom configuration channels (see [Using API Custom Configuration Channels](/docs/using-api-custom-configuration-channels-1)). - Manually on individual endpoints by changing the agent configuration file (see [Modifying the Configuration File for a Single Endpoint](/docs/modifying-the-configuration-file-for-a-single-endpoint-1)). For manual changes, the proxy `password` setting should be listed within quotation marks ("). Enclose the full list of proxy server settings in braces ({}). `{` `"proxy": {` `"type": "manual",` `"host": "proxy.fireeye.com",` `"port": 80,` `"exclude_hosts": ["eng.fireeye.com", "host.fireeye.com"],` `"exclude_local_hosts": true,` `"username": "<proxy-user>",` `"password": "<proxy-user-password>"` `}` ##### proxy failed_relay_delay Key The proxy `failed_relay_delay` setting defines how long the agent will wait (in seconds) before attempting to reconnect with the proxy server if the initial proxy server connection fails. The default value is 1200 seconds. If you define a `failed_relay_delay` interval for your proxy server, you must also define the following: - [proxy type Key](/docs/proxy-server-section-settings-1#UUID-999507ac-4c60-f7b4-c4f3-b29fcd40520b) - [proxy failed_relay_delay Key](/docs/proxy-server-section-settings-1#UUID-1edd89e4-697d-e350-3c5e-6c6add808a63) - [proxy port Key](/docs/proxy-server-section-settings-1#UUID-246cb84b-7965-d5cc-72da-3b0e55934fa7) The proxy `failed_relay_delay` setting should be listed within quotation marks ("). Enclose the full list of proxy server settings in braces ({}). For example, you can add `"exclude_hosts": "eng.fireeye.com", "host.fireeye.com"`to the `exclude_hosts` list. `{` `"proxy": {` `"type": "manual",` `"host": "<hostname>",` `"port": 80,` `"exclude_hosts": ["eng.fireeye.com", "host.fireeye.com"],` `"failed_relay_delay": 1200` `}` Change this setting using one of the following methods: - Web UI (see [Enabling and Disabling the Agent Logging Policy](/docs/enabling-and-disabling-the-xagent-logging-policy-1)). - CLI (see [Enabling and Disabling the Agent Logging Policy](/docs/enabling-and-disabling-the-xagent-logging-policy-1)). - API custom configuration channels (see [Using API Custom Configuration Channels](/docs/using-api-custom-configuration-channels-1)). - Manually on individual endpoints using a text editor (see [Modifying the Configuration File for a Single Endpoint](/docs/modifying-the-configuration-file-for-a-single-endpoint-1)). :