docs/content/reference/routing-configuration/other-providers/kv.md
??? example "Configuring KV Store & Deploying / Exposing one Service"
Enabling a KV store provider (example: Consul)
```yaml tab="Structured (YAML)"
providers:
consul:
endpoints:
- "127.0.0.1:8500"
```
```toml tab="Structured (TOML)"
[providers.consul]
endpoints = ["127.0.0.1:8500"]
```
```bash tab="CLI"
--providers.consul.endpoints=127.0.0.1:8500
```
Setting keys in the KV store (example: Consul)
```bash
consul kv put traefik/http/routers/my-router/rule "Host(`example.com`)"
consul kv put traefik/http/routers/my-router/service "my-service"
consul kv put traefik/http/services/my-service/loadbalancer/servers/0/url "http://127.0.0.1:8080"
```
??? example "Specify a Custom Port for the Service"
Forward requests for `http://example.com` to `http://127.0.0.1:12345`:
```bash
consul kv put traefik/http/routers/my-router/rule "Host(`example.com`)"
consul kv put traefik/http/routers/my-router/service "my-service"
consul kv put traefik/http/services/my-service/loadbalancer/servers/0/url "http://127.0.0.1:12345"
```
??? example "Specifying more than one router and service"
Forwarding requests to more than one service requires defining multiple routers and services.
In this example, requests are forwarded for `http://example-a.com` to `http://127.0.0.1:8000` in addition to `http://example-b.com` forwarding to `http://127.0.0.1:9000`:
```bash
consul kv put traefik/http/routers/www-router/rule "Host(`example-a.com`)"
consul kv put traefik/http/routers/www-router/service "www-service"
consul kv put traefik/http/services/www-service/loadbalancer/servers/0/url "http://127.0.0.1:8000"
consul kv put traefik/http/routers/admin-router/rule "Host(`example-b.com`)"
consul kv put traefik/http/routers/admin-router/service "admin-service"
consul kv put traefik/http/services/admin-service/loadbalancer/servers/0/url "http://127.0.0.1:9000"
```
!!! info "Keys"
Keys are case-insensitive.
!!! warning "The character @ is not authorized in the router name <router_name>."
| Key (Path) | Description | Value |
|---|---|---|
<a id="opt-traefikhttproutersrouter-namerule" href="#opt-traefikhttproutersrouter-namerule" title="#opt-traefikhttproutersrouter-namerule">traefik/http/routers/<router_name>/rule</a> | See rule for more information. | Host(`example.com`) |
<a id="opt-traefikhttproutersrouter-nameruleSyntax" href="#opt-traefikhttproutersrouter-nameruleSyntax" title="#opt-traefikhttproutersrouter-nameruleSyntax">traefik/http/routers/<router_name>/ruleSyntax</a> | See rule for more information. | |
| RuleSyntax option is deprecated and will be removed in the next major version. | ||
| Please do not use this field and rewrite the router rules to use the v3 syntax. | v3 | |
<a id="opt-traefikhttproutersrouter-nameentrypoints0" href="#opt-traefikhttproutersrouter-nameentrypoints0" title="#opt-traefikhttproutersrouter-nameentrypoints0">traefik/http/routers/<router_name>/entrypoints/0</a> | See entry points for more information. | web |
<a id="opt-traefikhttproutersrouter-nameentrypoints1" href="#opt-traefikhttproutersrouter-nameentrypoints1" title="#opt-traefikhttproutersrouter-nameentrypoints1">traefik/http/routers/<router_name>/entrypoints/1</a> | See entry points for more information. | websecure |
<a id="opt-traefikhttproutersrouter-namemiddlewares0" href="#opt-traefikhttproutersrouter-namemiddlewares0" title="#opt-traefikhttproutersrouter-namemiddlewares0">traefik/http/routers/<router_name>/middlewares/0</a> | See middlewares overview for more information. | auth |
<a id="opt-traefikhttproutersrouter-namemiddlewares1" href="#opt-traefikhttproutersrouter-namemiddlewares1" title="#opt-traefikhttproutersrouter-namemiddlewares1">traefik/http/routers/<router_name>/middlewares/1</a> | prefix | |
<a id="opt-traefikhttproutersrouter-nameservice" href="#opt-traefikhttproutersrouter-nameservice" title="#opt-traefikhttproutersrouter-nameservice">traefik/http/routers/<router_name>/service</a> | See service for more information. | myservice |
<a id="opt-traefikhttproutersrouter-nametls" href="#opt-traefikhttproutersrouter-nametls" title="#opt-traefikhttproutersrouter-nametls">traefik/http/routers/<router_name>/tls</a> | See tls for more information. | true |
<a id="opt-traefikhttproutersrouter-nametlscertresolver" href="#opt-traefikhttproutersrouter-nametlscertresolver" title="#opt-traefikhttproutersrouter-nametlscertresolver">traefik/http/routers/<router_name>/tls/certresolver</a> | See certResolver for more information. | myresolver |
<a id="opt-traefikhttproutersrouter-nametlsdomains0main" href="#opt-traefikhttproutersrouter-nametlsdomains0main" title="#opt-traefikhttproutersrouter-nametlsdomains0main">traefik/http/routers/<router_name>/tls/domains/0/main</a> | See domains for more information. | example.org |
<a id="opt-traefikhttproutersrouter-nametlsdomains0sans0" href="#opt-traefikhttproutersrouter-nametlsdomains0sans0" title="#opt-traefikhttproutersrouter-nametlsdomains0sans0">traefik/http/routers/<router_name>/tls/domains/0/sans/0</a> | See domains for more information. | test.example.org |
<a id="opt-traefikhttproutersrouter-nametlsdomains0sans1" href="#opt-traefikhttproutersrouter-nametlsdomains0sans1" title="#opt-traefikhttproutersrouter-nametlsdomains0sans1">traefik/http/routers/<router_name>/tls/domains/0/sans/1</a> | See domains for more information. | dev.example.org |
<a id="opt-traefikhttproutersrouter-nametlsoptions" href="#opt-traefikhttproutersrouter-nametlsoptions" title="#opt-traefikhttproutersrouter-nametlsoptions">traefik/http/routers/<router_name>/tls/options</a> | See TLS Options for more information. | foobar |
<a id="opt-traefikhttproutersrouter-nameobservabilityaccesslogs" href="#opt-traefikhttproutersrouter-nameobservabilityaccesslogs" title="#opt-traefikhttproutersrouter-nameobservabilityaccesslogs">traefik/http/routers/<router_name>/observability/accesslogs</a> | The accessLogs option controls whether the router will produce access-logs. | true |
<a id="opt-traefikhttproutersrouter-nameobservabilitymetrics" href="#opt-traefikhttproutersrouter-nameobservabilitymetrics" title="#opt-traefikhttproutersrouter-nameobservabilitymetrics">traefik/http/routers/<router_name>/observability/metrics</a> | The metrics option controls whether the router will produce metrics. | true |
<a id="opt-traefikhttproutersrouter-nameobservabilitytracing" href="#opt-traefikhttproutersrouter-nameobservabilitytracing" title="#opt-traefikhttproutersrouter-nameobservabilitytracing">traefik/http/routers/<router_name>/observability/tracing</a> | The tracing option controls whether the router will produce traces. | true |
<a id="opt-traefikhttproutersrouter-namepriority" href="#opt-traefikhttproutersrouter-namepriority" title="#opt-traefikhttproutersrouter-namepriority">traefik/http/routers/<router_name>/priority</a> | See priority for more information. | 42 |
!!! warning "The character @ is not authorized in the service name <service_name>."
| Key (Path) | Description | Value |
|---|---|---|
<a id="opt-traefikhttpservicesservice-nameloadbalancerservers0url" href="#opt-traefikhttpservicesservice-nameloadbalancerservers0url" title="#opt-traefikhttpservicesservice-nameloadbalancerservers0url">traefik/http/services/<service_name>/loadbalancer/servers/0/url</a> | See servers for more information. | http://<ip-server-1>:<port-server-1>/ |
<a id="opt-traefikhttpservicesservice-nameloadbalancerservers0preservePath" href="#opt-traefikhttpservicesservice-nameloadbalancerservers0preservePath" title="#opt-traefikhttpservicesservice-nameloadbalancerservers0preservePath">traefik/http/services/<service_name>/loadbalancer/servers/0/preservePath</a> | See servers for more information. | true |
<a id="opt-traefikhttpservicesservice-nameloadbalancerservers0weight" href="#opt-traefikhttpservicesservice-nameloadbalancerservers0weight" title="#opt-traefikhttpservicesservice-nameloadbalancerservers0weight">traefik/http/services/<service_name>/loadbalancer/servers/0/weight</a> | See servers for more information. | 1 |
<a id="opt-traefikhttpservicesservice-nameloadbalancerserverstransport" href="#opt-traefikhttpservicesservice-nameloadbalancerserverstransport" title="#opt-traefikhttpservicesservice-nameloadbalancerserverstransport">traefik/http/services/<service_name>/loadbalancer/serverstransport</a> | Allows to reference a ServersTransport resource that is defined either with the File provider or the Kubernetes CRD one. | |
| See serverstransport for more information. | foobar@file | |
<a id="opt-traefikhttpservicesservice-nameloadbalancerpasshostheader" href="#opt-traefikhttpservicesservice-nameloadbalancerpasshostheader" title="#opt-traefikhttpservicesservice-nameloadbalancerpasshostheader">traefik/http/services/<service_name>/loadbalancer/passhostheader</a> | See Service for more information. | true |
<a id="opt-traefikhttpservicesservice-nameloadbalancerhealthcheckheadersX-Foo" href="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckheadersX-Foo" title="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckheadersX-Foo">traefik/http/services/<service_name>/loadbalancer/healthcheck/headers/X-Foo</a> | See health check for more information. | foobar |
<a id="opt-traefikhttpservicesservice-nameloadbalancerhealthcheckhostname" href="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckhostname" title="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckhostname">traefik/http/services/<service_name>/loadbalancer/healthcheck/hostname</a> | See health check for more information. | example.org |
<a id="opt-traefikhttpservicesservice-nameloadbalancerhealthcheckinterval" href="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckinterval" title="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckinterval">traefik/http/services/<service_name>/loadbalancer/healthcheck/interval</a> | See health check for more information. | 10 |
<a id="opt-traefikhttpservicesservice-nameloadbalancerhealthcheckpath" href="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckpath" title="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckpath">traefik/http/services/<service_name>/loadbalancer/healthcheck/path</a> | See health check for more information. | /foo |
<a id="opt-traefikhttpservicesservice-nameloadbalancerhealthcheckmethod" href="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckmethod" title="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckmethod">traefik/http/services/<service_name>/loadbalancer/healthcheck/method</a> | See health check for more information. | foobar |
<a id="opt-traefikhttpservicesservice-nameloadbalancerhealthcheckstatus" href="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckstatus" title="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckstatus">traefik/http/services/<service_name>/loadbalancer/healthcheck/status</a> | See health check for more information. | 42 |
<a id="opt-traefikhttpservicesservice-nameloadbalancerhealthcheckport" href="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckport" title="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckport">traefik/http/services/<service_name>/loadbalancer/healthcheck/port</a> | See health check for more information. | 42 |
<a id="opt-traefikhttpservicesservice-nameloadbalancerhealthcheckscheme" href="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckscheme" title="#opt-traefikhttpservicesservice-nameloadbalancerhealthcheckscheme">traefik/http/services/<service_name>/loadbalancer/healthcheck/scheme</a> | See health check for more information. | http |
<a id="opt-traefikhttpservicesservice-nameloadbalancerhealthchecktimeout" href="#opt-traefikhttpservicesservice-nameloadbalancerhealthchecktimeout" title="#opt-traefikhttpservicesservice-nameloadbalancerhealthchecktimeout">traefik/http/services/<service_name>/loadbalancer/healthcheck/timeout</a> | See health check for more information. | 10 |
<a id="opt-traefikhttpservicesservice-nameloadbalancersticky" href="#opt-traefikhttpservicesservice-nameloadbalancersticky" title="#opt-traefikhttpservicesservice-nameloadbalancersticky">traefik/http/services/<service_name>/loadbalancer/sticky</a> | See Service for more information. | true |
<a id="opt-traefikhttpservicesservice-nameloadbalancerstickycookiehttponly" href="#opt-traefikhttpservicesservice-nameloadbalancerstickycookiehttponly" title="#opt-traefikhttpservicesservice-nameloadbalancerstickycookiehttponly">traefik/http/services/<service_name>/loadbalancer/sticky/cookie/httponly</a> | See Service for more information. | true |
<a id="opt-traefikhttpservicesservice-nameloadbalancerstickycookiename" href="#opt-traefikhttpservicesservice-nameloadbalancerstickycookiename" title="#opt-traefikhttpservicesservice-nameloadbalancerstickycookiename">traefik/http/services/<service_name>/loadbalancer/sticky/cookie/name</a> | See Service for more information. | foobar |
<a id="opt-traefikhttpservicesservice-nameloadbalancerstickycookiepath" href="#opt-traefikhttpservicesservice-nameloadbalancerstickycookiepath" title="#opt-traefikhttpservicesservice-nameloadbalancerstickycookiepath">traefik/http/services/<service_name>/loadbalancer/sticky/cookie/path</a> | See Service for more information. | /foobar |
<a id="opt-traefikhttpservicesservice-nameloadbalancerstickycookiesecure" href="#opt-traefikhttpservicesservice-nameloadbalancerstickycookiesecure" title="#opt-traefikhttpservicesservice-nameloadbalancerstickycookiesecure">traefik/http/services/<service_name>/loadbalancer/sticky/cookie/secure</a> | See Service for more information. | true |
<a id="opt-traefikhttpservicesservice-nameloadbalancerstickycookiesamesite" href="#opt-traefikhttpservicesservice-nameloadbalancerstickycookiesamesite" title="#opt-traefikhttpservicesservice-nameloadbalancerstickycookiesamesite">traefik/http/services/<service_name>/loadbalancer/sticky/cookie/samesite</a> | See Service for more information. | none |
<a id="opt-traefikhttpservicesservice-nameloadbalancerstickycookiemaxage" href="#opt-traefikhttpservicesservice-nameloadbalancerstickycookiemaxage" title="#opt-traefikhttpservicesservice-nameloadbalancerstickycookiemaxage">traefik/http/services/<service_name>/loadbalancer/sticky/cookie/maxage</a> | See Service for more information. | 42 |
<a id="opt-traefikhttpservicesmyserviceloadbalancerresponseforwardingflushinterval" href="#opt-traefikhttpservicesmyserviceloadbalancerresponseforwardingflushinterval" title="#opt-traefikhttpservicesmyserviceloadbalancerresponseforwardingflushinterval">traefik/http/services/myservice/loadbalancer/responseforwarding/flushinterval</a> | See Service for more information. | 10 |
<a id="opt-traefikhttpservicesservice-namemirroringservice" href="#opt-traefikhttpservicesservice-namemirroringservice" title="#opt-traefikhttpservicesservice-namemirroringservice">traefik/http/services/<service_name>/mirroring/service</a> | See Service for more information. | foobar |
<a id="opt-traefikhttpservicesservice-namemirroringmirrorsnname" href="#opt-traefikhttpservicesservice-namemirroringmirrorsnname" title="#opt-traefikhttpservicesservice-namemirroringmirrorsnname">traefik/http/services/<service_name>/mirroring/mirrors/<n>/name</a> | See Service for more information. | foobar |
<a id="opt-traefikhttpservicesservice-namemirroringmirrorsnpercent" href="#opt-traefikhttpservicesservice-namemirroringmirrorsnpercent" title="#opt-traefikhttpservicesservice-namemirroringmirrorsnpercent">traefik/http/services/<service_name>/mirroring/mirrors/<n>/percent</a> | See Servicefor more information. | 42 |
<a id="opt-traefikhttpservicesservice-nameweightedservicesnname" href="#opt-traefikhttpservicesservice-nameweightedservicesnname" title="#opt-traefikhttpservicesservice-nameweightedservicesnname">traefik/http/services/<service_name>/weighted/services/<n>/name</a> | See Service for more information. | foobar |
<a id="opt-traefikhttpservicesservice-nameweightedservicesnweight" href="#opt-traefikhttpservicesservice-nameweightedservicesnweight" title="#opt-traefikhttpservicesservice-nameweightedservicesnweight">traefik/http/services/<service_name>/weighted/services/<n>/weight</a> | See Service for more information. | 42 |
<a id="opt-traefikhttpservicesservice-nameweightedstickycookiename" href="#opt-traefikhttpservicesservice-nameweightedstickycookiename" title="#opt-traefikhttpservicesservice-nameweightedstickycookiename">traefik/http/services/<service_name>/weighted/sticky/cookie/name</a> | See Service for more information. | foobar |
<a id="opt-traefikhttpservicesservice-nameweightedstickycookiesecure" href="#opt-traefikhttpservicesservice-nameweightedstickycookiesecure" title="#opt-traefikhttpservicesservice-nameweightedstickycookiesecure">traefik/http/services/<service_name>/weighted/sticky/cookie/secure</a> | See Service for more information. | true |
<a id="opt-traefikhttpservicesservice-nameweightedstickycookiesamesite" href="#opt-traefikhttpservicesservice-nameweightedstickycookiesamesite" title="#opt-traefikhttpservicesservice-nameweightedstickycookiesamesite">traefik/http/services/<service_name>/weighted/sticky/cookie/samesite</a> | See Service for more information. | none |
<a id="opt-traefikhttpservicesservice-nameweightedstickycookiehttpOnly" href="#opt-traefikhttpservicesservice-nameweightedstickycookiehttpOnly" title="#opt-traefikhttpservicesservice-nameweightedstickycookiehttpOnly">traefik/http/services/<service_name>/weighted/sticky/cookie/httpOnly</a> | See Service for more information. | true |
<a id="opt-traefikhttpservicesservice-nameweightedstickycookiemaxage" href="#opt-traefikhttpservicesservice-nameweightedstickycookiemaxage" title="#opt-traefikhttpservicesservice-nameweightedstickycookiemaxage">traefik/http/services/<service_name>/weighted/sticky/cookie/maxage</a> | See Service for more information. | 42 |
<a id="opt-traefikhttpservicesservice-namefailoverfallback" href="#opt-traefikhttpservicesservice-namefailoverfallback" title="#opt-traefikhttpservicesservice-namefailoverfallback">traefik/http/services/<service_name>/failover/fallback</a> | See Failover for more information. | backup |
<a id="opt-traefikhttpservicesservice-namefailoverhealthcheck" href="#opt-traefikhttpservicesservice-namefailoverhealthcheck" title="#opt-traefikhttpservicesservice-namefailoverhealthcheck">traefik/http/services/<service_name>/failover/healthcheck</a> | See Failover for more information. | {} |
<a id="opt-traefikhttpservicesservice-namefailoverservice" href="#opt-traefikhttpservicesservice-namefailoverservice" title="#opt-traefikhttpservicesservice-namefailoverservice">traefik/http/services/<service_name>/failover/service</a> | See Failover for more information. | main |
| Key (Path) | Description | Value |
|---|---|---|
<a id="opt-traefikhttpmiddlewaresmiddleware-namemiddleware-typemiddleware-option" href="#opt-traefikhttpmiddlewaresmiddleware-namemiddleware-typemiddleware-option" title="#opt-traefikhttpmiddlewaresmiddleware-namemiddleware-typemiddleware-option">traefik/http/middlewares/<middleware_name>/middleware_type/middleware_option</a> | With middleware_type the type of middleware (ex: forwardAuth, headers, etc) | |
and middleware_option the middleware option to set (ex for the middleware addPrefix: prefix). | ||
| More information about available middlewares in the dedicated middlewares section. | foobar |
!!! warning "The character @ is not authorized in the middleware name."
!!! warning "Conflicts in Declaration"
If you declare multiple middleware with the same name but with different parameters, the middleware fails to be declared.
| Key (Path) | Description | Value |
|---|---|---|
<a id="opt-traefikhttpserversTransportsservers-transport-namest-option" href="#opt-traefikhttpserversTransportsservers-transport-namest-option" title="#opt-traefikhttpserversTransportsservers-transport-namest-option">traefik/http/serversTransports/<servers_transport_name>/st_option</a> | With st_option the ServerTransport option to set (ex maxIdleConnsPerHost). | |
| More information about available options in the dedicated ServerTransport section. | ServerTransport Options |
You can declare TCP Routers and/or Services using KV.
| Key (Path) | Description | Value |
|---|---|---|
<a id="opt-traefiktcproutersrouter-nameentrypoints0" href="#opt-traefiktcproutersrouter-nameentrypoints0" title="#opt-traefiktcproutersrouter-nameentrypoints0">traefik/tcp/routers/<router_name>/entrypoints/0</a> | See entry points for more information. | ep1 |
<a id="opt-traefiktcproutersrouter-nameentrypoints1" href="#opt-traefiktcproutersrouter-nameentrypoints1" title="#opt-traefiktcproutersrouter-nameentrypoints1">traefik/tcp/routers/<router_name>/entrypoints/1</a> | See entry points for more information. | ep2 |
<a id="opt-traefiktcproutersmy-routerrule" href="#opt-traefiktcproutersmy-routerrule" title="#opt-traefiktcproutersmy-routerrule">traefik/tcp/routers/my-router/rule</a> | See entry points for more information. | HostSNI(`example.com`) |
<a id="opt-traefiktcproutersrouter-nameservice" href="#opt-traefiktcproutersrouter-nameservice" title="#opt-traefiktcproutersrouter-nameservice">traefik/tcp/routers/<router_name>/service</a> | See service for more information. | myservice |
<a id="opt-traefiktcproutersrouter-nametls" href="#opt-traefiktcproutersrouter-nametls" title="#opt-traefiktcproutersrouter-nametls">traefik/tcp/routers/<router_name>/tls</a> | See TLS for more information. | true |
<a id="opt-traefiktcproutersrouter-nametlscertresolver" href="#opt-traefiktcproutersrouter-nametlscertresolver" title="#opt-traefiktcproutersrouter-nametlscertresolver">traefik/tcp/routers/<router_name>/tls/certresolver</a> | See certResolver for more information. | myresolver |
<a id="opt-traefiktcproutersrouter-nametlsdomains0main" href="#opt-traefiktcproutersrouter-nametlsdomains0main" title="#opt-traefiktcproutersrouter-nametlsdomains0main">traefik/tcp/routers/<router_name>/tls/domains/0/main</a> | See TLS for more information. | example.org |
<a id="opt-traefiktcproutersrouter-nametlsdomains0sans0" href="#opt-traefiktcproutersrouter-nametlsdomains0sans0" title="#opt-traefiktcproutersrouter-nametlsdomains0sans0">traefik/tcp/routers/<router_name>/tls/domains/0/sans/0</a> | See TLS for more information. | test.example.org |
<a id="opt-traefiktcproutersrouter-nametlsdomains0sans1" href="#opt-traefiktcproutersrouter-nametlsdomains0sans1" title="#opt-traefiktcproutersrouter-nametlsdomains0sans1">traefik/tcp/routers/<router_name>/tls/domains/0/sans/1</a> | See TLS for more information. | dev.example.org |
<a id="opt-traefiktcproutersrouter-nametlsoptions" href="#opt-traefiktcproutersrouter-nametlsoptions" title="#opt-traefiktcproutersrouter-nametlsoptions">traefik/tcp/routers/<router_name>/tls/options</a> | See TLS for more information. | foobar |
<a id="opt-traefiktcproutersrouter-nametlspassthrough" href="#opt-traefiktcproutersrouter-nametlspassthrough" title="#opt-traefiktcproutersrouter-nametlspassthrough">traefik/tcp/routers/<router_name>/tls/passthrough</a> | See TLS for more information. | true |
<a id="opt-traefiktcproutersrouter-namepriority" href="#opt-traefiktcproutersrouter-namepriority" title="#opt-traefiktcproutersrouter-namepriority">traefik/tcp/routers/<router_name>/priority</a> | See priority for more information. | 42 |
| Key (Path) | Description | Value |
|---|---|---|
<a id="opt-traefiktcpservicesservice-nameloadbalancerservers0address" href="#opt-traefiktcpservicesservice-nameloadbalancerservers0address" title="#opt-traefiktcpservicesservice-nameloadbalancerservers0address">traefik/tcp/services/<service_name>/loadbalancer/servers/0/address</a> | See servers for more information. | xx.xx.xx.xx:xx |
<a id="opt-traefiktcpservicesservice-nameloadbalancerservers0tls" href="#opt-traefiktcpservicesservice-nameloadbalancerservers0tls" title="#opt-traefiktcpservicesservice-nameloadbalancerservers0tls">traefik/tcp/services/<service_name>/loadbalancer/servers/0/tls</a> | See servers for more information. | true |
<a id="opt-traefiktcpservicesservice-nameloadbalancerserverstransport" href="#opt-traefiktcpservicesservice-nameloadbalancerserverstransport" title="#opt-traefiktcpservicesservice-nameloadbalancerserverstransport">traefik/tcp/services/<service_name>/loadbalancer/serverstransport</a> | Allows to reference a ServersTransport resource that is defined either with the File provider or the Kubernetes CRD one. | |
| See serverstransport for more information. | foobar@file | |
<a id="opt-traefiktcpservicesservice-nameweightedservices0name" href="#opt-traefiktcpservicesservice-nameweightedservices0name" title="#opt-traefiktcpservicesservice-nameweightedservices0name">traefik/tcp/services/<service_name>/weighted/services/0/name</a> | See Service for more information. | foobar |
<a id="opt-traefiktcpservicesservice-nameweightedservices0weight" href="#opt-traefiktcpservicesservice-nameweightedservices0weight" title="#opt-traefiktcpservicesservice-nameweightedservices0weight">traefik/tcp/services/<service_name>/weighted/services/0/weight</a> | See Service for more information. | 42 |
You can declare pieces of middleware using tags starting with traefik/tcp/middlewares/{name-of-your-choice}., followed by the middleware type/options.
For example, to declare a middleware InFlightConn named test-inflightconn, you'd write traefik/tcp/middlewares/test-inflightconn/inflightconn/amount=10.
More information about available middlewares in the dedicated middlewares section.
| Key (Path) | Description | Value |
|---|---|---|
<a id="opt-traefiktcpmiddlewaresmiddleware-namemiddleware-typemiddleware-option" href="#opt-traefiktcpmiddlewaresmiddleware-namemiddleware-typemiddleware-option" title="#opt-traefiktcpmiddlewaresmiddleware-namemiddleware-typemiddleware-option">traefik/tcp/middlewares/<middleware_name>/middleware_type/middleware_option</a> | With middleware_type the type of middleware (ex: inflightconn) | |
and middleware_option the middleware option to set (ex for the middleware inflightconn: amount). | ||
| More information about available middlewares in the dedicated middlewares section. | foobar |
!!! warning "Conflicts in Declaration"
If you declare multiple middleware with the same name but with different parameters, the middleware fails to be declared.
| Key (Path) | Description | Value |
|---|---|---|
<a id="opt-traefiktcpserversTransportsservers-transport-namest-option" href="#opt-traefiktcpserversTransportsservers-transport-namest-option" title="#opt-traefiktcpserversTransportsservers-transport-namest-option">traefik/tcp/serversTransports/<servers_transport_name>/st_option</a> | With st_option the ServerTransport option to set (ex maxIdleConnsPerHost). | |
| More information about available options in the dedicated ServerTransport section. | ServerTransport Options |
You can declare UDP Routers and/or Services using KV.
| Key (Path) | Description | Value |
|---|---|---|
<a id="opt-traefikudproutersrouter-nameentrypoints0" href="#opt-traefikudproutersrouter-nameentrypoints0" title="#opt-traefikudproutersrouter-nameentrypoints0">traefik/udp/routers/<router_name>/entrypoints/0</a> | See UDP Router for more information. | foobar |
<a id="opt-traefikudproutersrouter-nameservice" href="#opt-traefikudproutersrouter-nameservice" title="#opt-traefikudproutersrouter-nameservice">traefik/udp/routers/<router_name>/service</a> | See UDP Router for more information. | foobar |
| Key (Path) | Description | Value |
|---|---|---|
<a id="opt-traefikudpservicesservice-nameloadBalancerserversnaddress" href="#opt-traefikudpservicesservice-nameloadBalancerserversnaddress" title="#opt-traefikudpservicesservice-nameloadBalancerserversnaddress">traefik/udp/services/<service_name>/loadBalancer/servers/<n>/address</a> | See UDP Service for more information. | foobar |
<a id="opt-traefikudpservicesservice-nameweightedservices0name" href="#opt-traefikudpservicesservice-nameweightedservices0name" title="#opt-traefikudpservicesservice-nameweightedservices0name">traefik/udp/services/<service_name>/weighted/services/0/name</a> | See UDP Service for more information. | foobar |
<a id="opt-traefikudpservicesservice-nameweightedservices0weight" href="#opt-traefikudpservicesservice-nameweightedservices0weight" title="#opt-traefikudpservicesservice-nameweightedservices0weight">traefik/udp/services/<service_name>/weighted/services/0/weight</a> | See UDP Service for more information. | 42 |
With the KV provider, you configure some parameters of the TLS connection using the tls/options key.
For example, you can define a basic setup like this:
| Key (Path) | Description | Value |
|---|---|---|
<a id="opt-traefiktlsoptionsOptions0alpnProtocols0" href="#opt-traefiktlsoptionsOptions0alpnProtocols0" title="#opt-traefiktlsoptionsOptions0alpnProtocols0">traefik/tls/options/Options0/alpnProtocols/0</a> | See TLS Options for more information. | foobar |
<a id="opt-traefiktlsoptionsOptions0cipherSuites0" href="#opt-traefiktlsoptionsOptions0cipherSuites0" title="#opt-traefiktlsoptionsOptions0cipherSuites0">traefik/tls/options/Options0/cipherSuites/0</a> | See TLS Options for more information. | foobar |
<a id="opt-traefiktlsoptionsOptions0clientAuthcaFiles0" href="#opt-traefiktlsoptionsOptions0clientAuthcaFiles0" title="#opt-traefiktlsoptionsOptions0clientAuthcaFiles0">traefik/tls/options/Options0/clientAuth/caFiles/0</a> | See TLS Options for more information. | foobar |
<a id="opt-traefiktlsoptionsOptions0disableSessiontickets" href="#opt-traefiktlsoptionsOptions0disableSessiontickets" title="#opt-traefiktlsoptionsOptions0disableSessiontickets">traefik/tls/options/Options0/disableSessiontickets</a> | See TLS Options for more information. | true |
You can configure Traefik to use an ACME provider (like Let's Encrypt) to generate the default certificate.
The configuration to resolve the default certificate should be defined in a TLS store.
| Key (Path) | Description | Value |
|---|---|---|
<a id="opt-traefiktlsstoresStore0defaultGeneratedCertdomainmain" href="#opt-traefiktlsstoresStore0defaultGeneratedCertdomainmain" title="#opt-traefiktlsstoresStore0defaultGeneratedCertdomainmain">traefik/tls/stores/Store0/defaultGeneratedCert/domain/main</a> | See TLS for more information. | foobar |
<a id="opt-traefiktlsstoresStore0defaultGeneratedCertdomainsans0" href="#opt-traefiktlsstoresStore0defaultGeneratedCertdomainsans0" title="#opt-traefiktlsstoresStore0defaultGeneratedCertdomainsans0">traefik/tls/stores/Store0/defaultGeneratedCert/domain/sans/0</a> | See TLS for more information | foobar |
<a id="opt-traefiktlsstoresStore0defaultGeneratedCertdomainsans1" href="#opt-traefiktlsstoresStore0defaultGeneratedCertdomainsans1" title="#opt-traefiktlsstoresStore0defaultGeneratedCertdomainsans1">traefik/tls/stores/Store0/defaultGeneratedCert/domain/sans/1</a> | See TLS for more information | foobar |
<a id="opt-traefiktlsstoresStore0defaultGeneratedCertresolver" href="#opt-traefiktlsstoresStore0defaultGeneratedCertresolver" title="#opt-traefiktlsstoresStore0defaultGeneratedCertresolver">traefik/tls/stores/Store0/defaultGeneratedCert/resolver</a> | See TLS for more information | foobar |