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

Configuration Options¶

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.maxResponseBodySize`	Defines the maximum size of the response body in bytes. A value of `-1` means unlimited.	-1	No
`providers.http.tls.ca`	Defines the certificate authority used for the secure connection to the endpoint, it defaults to the system bundle. The value can be a file path or the PEM content directly.	""	No
`providers.http.tls.cert`	Defines the public certificate used for the secure connection to the endpoint. The value can be a file path or the PEM content directly. When using this option, setting the `key` option is required.	""	Yes
`providers.http.tls.key`	Defines the private key used for the secure connection to the endpoint. The value can be a file path or the PEM content directly. 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

headers¶

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

Routing Configuration¶

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