Traefik & Consul

    Store your configuration in Consul and let Traefik do the rest!

    See the dedicated section in routing.

    Provider Configuration

    Required, Default=”127.0.0.1:8500”

    Defines how to access to Consul.

    File (YAML)

    File (TOML)

    1. [providers.consul]
    2.   endpoints = ["127.0.0.1:8500"]

    CLI

    1. --providers.consul.endpoints=127.0.0.1:8500

    Required, Default=”traefik”

    Defines the root key of the configuration.

    File (YAML)

    1. providers:
    2.   consul:
    3.     rootKey: "traefik"

    File (TOML)

    1. [providers.consul]
    2.   rootKey = "traefik"

    CLI

    1. --providers.consul.rootkey=traefik

    Optional, Default=””

    Defines a username to connect to Consul with.

    1. providers:
    2.     # ...
    3.     usename: "foo"

    File (TOML)

    1. [providers.consul]
    3.   username = "foo"

    CLI

    1. --providers.consul.username=foo

    Optional, Default=””

    Defines a password with which to connect to Consul.

    File (YAML)

    File (TOML)

    1. [providers.consul]
    2.   # ...
    3.   password = "bar"

    CLI

    1. --providers.consul.password=foo

    Optional

    tls.ca

    Certificate Authority used for the secure connection to Consul.

    File (YAML)

    1. providers:
    2.   consul:
    3.     tls:
    4.       ca: path/to/ca.crt

    File (TOML)

    1. [providers.consul.tls]
    2.   ca = "path/to/ca.crt"

    CLI

    1. --providers.consul.tls.ca=path/to/ca.crt

    tls.caOptional

    The value of tls.caOptional defines which policy should be used for the secure connection with TLS Client Authentication to Consul.

    If tls.ca is undefined, this option will be ignored, and no client certificate will be requested during the handshake. Any provided certificate will thus never be verified.

    When this option is set to false, a client certificate is requested during the handshake, and at least one valid certificate should be sent by the client.

    File (YAML)

    1. providers:
    2.   consul:
    3.     tls:
    4.       caOptional: true

    File (TOML)

    1. [providers.consul.tls]

    CLI

    1. --providers.consul.tls.caOptional=true

    tls.cert

    Public certificate used for the secure connection to Consul.

    File (YAML)

    File (TOML)

    1. [providers.consul.tls]
    2.   cert = "path/to/foo.cert"
    3.   key = "path/to/foo.key"

    CLI

    1. --providers.consul.tls.cert=path/to/foo.cert
    2. --providers.consul.tls.key=path/to/foo.key

    tls.key

    Private certificate used for the secure connection to Consul.

    File (YAML)

    1. providers:
    2.   consul:
    3.     tls:
    4.       cert: path/to/foo.cert
    5.       key: path/to/foo.key

    File (TOML)

    1. [providers.consul.tls]
    2.   cert = "path/to/foo.cert"
    3.   key = "path/to/foo.key"

    CLI

    1. --providers.consul.tls.cert=path/to/foo.cert
    2. --providers.consul.tls.key=path/to/foo.key

    tls.insecureSkipVerify

    If insecureSkipVerify is true, the TLS connection to Consul accepts any certificate presented by the server regardless of the hostnames it covers.

    File (YAML)

    1. providers:
    2.   consul:
    3.     tls:
    4.       insecureSkipVerify: true
    1. [providers.consul.tls]

    CLI