Traefik & HTTP¶

Provide your install configuration via an HTTP(S) endpoint and let Traefik do the rest!

Configuration Example¶

You can enable the HTTP provider as detailed below:

File (YAML)

providers:
  http:
    endpoint: "http://127.0.0.1:9000/api"

File (TOML)

[providers.http]
  endpoint = "http://127.0.0.1:9000/api"

CLI

--providers.http.endpoint=http://127.0.0.1:9000/api

Field	Description	Default	Required
`providers.providersThrottleDuration`	Minimum amount of time to wait for, after a configuration reload, before taking into account any new configuration refresh event. If multiple events occur within this time, only the most recent one is taken into account, and all others are discarded. This option cannot be set per provider, but the throttling algorithm applies to each of them independently.	2s	No
`providers.http.endpoint`	Defines the HTTP(S) endpoint to poll.	""	Yes
`providers.http.pollInterval`	Defines the polling interval.	5s	No
`providers.http.pollTimeout`	Defines the polling timeout when connecting to the endpoint.	5s	No
`providers.http.headers`	Defines custom headers to be sent to the endpoint.	""	No
`providers.http.tls.ca`	Defines the path to the certificate authority used for the secure connection to the endpoint, it defaults to the system bundle.	""	No
`providers.http.tls.cert`	Defines the path to the public certificate used for the secure connection to the endpoint. When using this option, setting the `key` option is required.	""	Yes
`providers.http.tls.key`	Defines the path to the private key used for the secure connection to the endpoint. When using this option, setting the `cert` option is required.	""	Yes
`providers.http.tls.insecureSkipVerify`	Instructs the provider to accept any certificate presented by endpoint when establishing a TLS connection, regardless of the hostnames the certificate covers.	false	No

Defines custom headers to be sent to the endpoint.

File (YAML)

providers:
  http:
    headers:
      name: value

File (TOML)

[providers.http.headers]
  name = "value"

CLI

[providers.http.headers]
--providers.http.headers.name=value

The HTTP provider uses the same configuration as the File Provider in YAML or JSON format.