New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Fleet managed Elastic Agent connectivity using a proxy server Set the proxy URL of the Elastic Package Registry »
Elastic Docs ›Fleet and Elastic Agent Guide [8.8] ›Install Elastic Agents ›Using a proxy server with Elastic Agent and Fleet

Standalone Elastic Agent connectivity using a proxy server

edit

Standalone Elastic Agent connectivity using a proxy server

edit

Proxy settings in the Elastic Agent policy override proxy settings specified by environment variables. This means you can specify proxy settings for Elastic Agent that are different from host or system-level environment settings.

The following proxy settings are valid in the agent policy:

Setting Description

proxy_url

(string) URL of the proxy server. If set, the configured URL is used as a proxy for all connection attempts by the component. The value may be either a complete URL or a host[:port], in which case the http scheme is assumed. If a value is not specified through the configuration, then proxy environment variables are used. The URL accepts optional username and password settings for authenticating with the proxy. For example: http://<username>:<password>@<proxy host>/.

proxy_headers

(string) Additional headers to send to the proxy during CONNECT requests. You can use this setting to pass keys/tokens required for authenticating with the proxy.

proxy_disable

(boolean) If set to true, all proxy settings, including the HTTP_PROXY and HTTPS_PROXY environment variables, are ignored.

Set the proxy for communicating with Elasticsearch

edit

For standalone agents, to set the proxy for communicating with Elasticsearch, specify proxy settings in the elastic-agent.yml file. For example:

outputs:
  default:
    api_key: API-KEY
    hosts:
    - https://10.0.1.2:9200
    proxy_url: http://10.0.1.7:3128
    type: elasticsearch

For more information, refer to Configure standalone Elastic Agents.

« Fleet managed Elastic Agent connectivity using a proxy server Set the proxy URL of the Elastic Package Registry »

On this page

Was this helpful?
Feedback