Standalone Elastic Agent connectivity using a proxy server | Fleet and Elastic Agent Guide [master]

You are looking at preliminary documentation for a future release. Not what you want? See the current release documentation.

› › ›

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

Standalone Elastic Agent connectivity using a proxy serveredit

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 Elasticsearchedit

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 »