traefik/docs/content/reference/static-configuration/cli-ref.md
2020-03-18 18:16:08 +01:00

26 KiB

--accesslog:
Access log settings. (Default: false)

--accesslog.bufferingsize:
Number of access log lines to process in a buffered way. (Default: 0)

--accesslog.fields.defaultmode:
Default mode for fields: keep | drop (Default: keep)

--accesslog.fields.headers.defaultmode:
Default mode for fields: keep | drop | redact (Default: drop)

--accesslog.fields.headers.names.<name>:
Override mode for headers

--accesslog.fields.names.<name>:
Override mode for fields

--accesslog.filepath:
Access log file path. Stdout is used when omitted or empty.

--accesslog.filters.minduration:
Keep access logs when request took longer than the specified duration. (Default: 0)

--accesslog.filters.retryattempts:
Keep access logs when at least one retry happened. (Default: false)

--accesslog.filters.statuscodes:
Keep access logs with status codes in the specified range.

--accesslog.format:
Access log format: json | common (Default: common)

--api:
Enable api/dashboard. (Default: false)

--api.dashboard:
Activate dashboard. (Default: true)

--api.debug:
Enable additional endpoints for debugging and profiling. (Default: false)

--api.insecure:
Activate API directly on the entryPoint named traefik. (Default: false)

--certificatesresolvers.<name>:
Certificates resolvers configuration. (Default: false)

--certificatesresolvers.<name>.acme.caserver:
CA server to use. (Default: https://acme-v02.api.letsencrypt.org/directory)

--certificatesresolvers.<name>.acme.dnschallenge:
Activate DNS-01 Challenge. (Default: false)

--certificatesresolvers.<name>.acme.dnschallenge.delaybeforecheck:
Assume DNS propagates after a delay in seconds rather than finding and querying nameservers. (Default: 0)

--certificatesresolvers.<name>.acme.dnschallenge.disablepropagationcheck:
Disable the DNS propagation checks before notifying ACME that the DNS challenge is ready. [not recommended] (Default: false)

--certificatesresolvers.<name>.acme.dnschallenge.provider:
Use a DNS-01 based challenge provider rather than HTTPS.

--certificatesresolvers.<name>.acme.dnschallenge.resolvers:
Use following DNS servers to resolve the FQDN authority.

--certificatesresolvers.<name>.acme.email:
Email address used for registration.

--certificatesresolvers.<name>.acme.httpchallenge:
Activate HTTP-01 Challenge. (Default: false)

--certificatesresolvers.<name>.acme.httpchallenge.entrypoint:
HTTP challenge EntryPoint

--certificatesresolvers.<name>.acme.keytype:
KeyType used for generating certificate private key. Allow value 'EC256', 'EC384', 'RSA2048', 'RSA4096', 'RSA8192'. (Default: RSA4096)

--certificatesresolvers.<name>.acme.storage:
Storage to use. (Default: acme.json)

--certificatesresolvers.<name>.acme.tlschallenge:
Activate TLS-ALPN-01 Challenge. (Default: true)

--entrypoints.<name>:
Entry points definition. (Default: false)

--entrypoints.<name>.address:
Entry point address.

--entrypoints.<name>.forwardedheaders.insecure:
Trust all forwarded headers. (Default: false)

--entrypoints.<name>.forwardedheaders.trustedips:
Trust only forwarded headers from selected IPs.

--entrypoints.<name>.http:
HTTP configuration.

--entrypoints.<name>.http.middlewares:
Default middlewares for the routers linked to the entry point.

--entrypoints.<name>.http.redirections.entrypoint.permanent:
Applied a permanent redirection. Defaults to true. (Default: true)

--entrypoints.<name>.http.redirections.entrypoint.priority:
Priority of the generated router. Defaults to 1. (Default: 1)

--entrypoints.<name>.http.redirections.entrypoint.scheme:
Scheme used for the redirection. Defaults to https. (Default: https)

--entrypoints.<name>.http.redirections.entrypoint.to:
Targeted entry point of the redirection.

--entrypoints.<name>.http.tls:
Default TLS configuration for the routers linked to the entry point. (Default: false)

--entrypoints.<name>.http.tls.certresolver:
Default certificate resolver for the routers linked to the entry point.

--entrypoints.<name>.http.tls.domains:
Default TLS domains for the routers linked to the entry point.

--entrypoints.<name>.http.tls.domains[n].main:
Default subject name.

--entrypoints.<name>.http.tls.domains[n].sans:
Subject alternative names.

--entrypoints.<name>.http.tls.options:
Default TLS options for the routers linked to the entry point.

--entrypoints.<name>.proxyprotocol:
Proxy-Protocol configuration. (Default: false)

--entrypoints.<name>.proxyprotocol.insecure:
Trust all. (Default: false)

--entrypoints.<name>.proxyprotocol.trustedips:
Trust only selected IPs.

--entrypoints.<name>.transport.lifecycle.gracetimeout:
Duration to give active requests a chance to finish before Traefik stops. (Default: 10)

--entrypoints.<name>.transport.lifecycle.requestacceptgracetimeout:
Duration to keep accepting requests before Traefik initiates the graceful shutdown procedure. (Default: 0)

--entrypoints.<name>.transport.respondingtimeouts.idletimeout:
IdleTimeout is the maximum amount duration an idle (keep-alive) connection will remain idle before closing itself. If zero, no timeout is set. (Default: 180)

--entrypoints.<name>.transport.respondingtimeouts.readtimeout:
ReadTimeout is the maximum duration for reading the entire request, including the body. If zero, no timeout is set. (Default: 0)

--entrypoints.<name>.transport.respondingtimeouts.writetimeout:
WriteTimeout is the maximum duration before timing out writes of the response. If zero, no timeout is set. (Default: 0)

--global.checknewversion:
Periodically check if a new version has been released. (Default: false)

--global.sendanonymoususage:
Periodically send anonymous usage statistics. If the option is not specified, it will be enabled by default. (Default: false)

--hostresolver:
Enable CNAME Flattening. (Default: false)

--hostresolver.cnameflattening:
A flag to enable/disable CNAME flattening (Default: false)

--hostresolver.resolvconfig:
resolv.conf used for DNS resolving (Default: /etc/resolv.conf)

--hostresolver.resolvdepth:
The maximal depth of DNS recursive resolving (Default: 5)

--log:
Traefik log settings. (Default: false)

--log.filepath:
Traefik log file path. Stdout is used when omitted or empty.

--log.format:
Traefik log format: json | common (Default: common)

--log.level:
Log level set to traefik logs. (Default: ERROR)

--metrics.datadog:
Datadog metrics exporter type. (Default: false)

--metrics.datadog.addentrypointslabels:
Enable metrics on entry points. (Default: true)

--metrics.datadog.address:
Datadog's address. (Default: localhost:8125)

--metrics.datadog.addserviceslabels:
Enable metrics on services. (Default: true)

--metrics.datadog.pushinterval:
Datadog push interval. (Default: 10)

--metrics.influxdb:
InfluxDB metrics exporter type. (Default: false)

--metrics.influxdb.addentrypointslabels:
Enable metrics on entry points. (Default: true)

--metrics.influxdb.address:
InfluxDB address. (Default: localhost:8089)

--metrics.influxdb.addserviceslabels:
Enable metrics on services. (Default: true)

--metrics.influxdb.database:
InfluxDB database used when protocol is http.

--metrics.influxdb.password:
InfluxDB password (only with http).

--metrics.influxdb.protocol:
InfluxDB address protocol (udp or http). (Default: udp)

--metrics.influxdb.pushinterval:
InfluxDB push interval. (Default: 10)

--metrics.influxdb.retentionpolicy:
InfluxDB retention policy used when protocol is http.

--metrics.influxdb.username:
InfluxDB username (only with http).

--metrics.prometheus:
Prometheus metrics exporter type. (Default: false)

--metrics.prometheus.addentrypointslabels:
Enable metrics on entry points. (Default: true)

--metrics.prometheus.addserviceslabels:
Enable metrics on services. (Default: true)

--metrics.prometheus.buckets:
Buckets for latency metrics. (Default: 0.100000, 0.300000, 1.200000, 5.000000)

--metrics.prometheus.entrypoint:
EntryPoint (Default: traefik)

--metrics.prometheus.manualrouting:
Manual routing (Default: false)

--metrics.statsd:
StatsD metrics exporter type. (Default: false)

--metrics.statsd.addentrypointslabels:
Enable metrics on entry points. (Default: true)

--metrics.statsd.address:
StatsD address. (Default: localhost:8125)

--metrics.statsd.addserviceslabels:
Enable metrics on services. (Default: true)

--metrics.statsd.prefix:
Prefix to use for metrics collection. (Default: traefik)

--metrics.statsd.pushinterval:
StatsD push interval. (Default: 10)

--ping:
Enable ping. (Default: false)

--ping.entrypoint:
EntryPoint (Default: traefik)

--ping.manualrouting:
Manual routing (Default: false)

--providers.consul:
Enable Consul backend with default settings. (Default: false)

--providers.consul.endpoints:
KV store endpoints (Default: 127.0.0.1:8500)

--providers.consul.password:
KV Password

--providers.consul.rootkey:
Root key used for KV store (Default: traefik)

--providers.consul.tls.ca:
TLS CA

--providers.consul.tls.caoptional:
TLS CA.Optional (Default: false)

--providers.consul.tls.cert:
TLS cert

--providers.consul.tls.insecureskipverify:
TLS insecure skip verify (Default: false)

--providers.consul.tls.key:
TLS key

--providers.consul.username:
KV Username

--providers.consulcatalog.cache:
Use local agent caching for catalog reads. (Default: false)

--providers.consulcatalog.constraints:
Constraints is an expression that Traefik matches against the container's labels to determine whether to create any route for that container.

--providers.consulcatalog.defaultrule:
Default rule. (Default: Host(`{{ normalize .Name }}`))

--providers.consulcatalog.endpoint.address:
The address of the Consul server (Default: http://127.0.0.1:8500)

--providers.consulcatalog.endpoint.datacenter:
Data center to use. If not provided, the default agent data center is used

--providers.consulcatalog.endpoint.endpointwaittime:
WaitTime limits how long a Watch will block. If not provided, the agent default values will be used (Default: 0)

--providers.consulcatalog.endpoint.httpauth.password:
Basic Auth password

--providers.consulcatalog.endpoint.httpauth.username:
Basic Auth username

--providers.consulcatalog.endpoint.scheme:
The URI scheme for the Consul server

--providers.consulcatalog.endpoint.tls.ca:
TLS CA

--providers.consulcatalog.endpoint.tls.caoptional:
TLS CA.Optional (Default: false)

--providers.consulcatalog.endpoint.tls.cert:
TLS cert

--providers.consulcatalog.endpoint.tls.insecureskipverify:
TLS insecure skip verify (Default: false)

--providers.consulcatalog.endpoint.tls.key:
TLS key

--providers.consulcatalog.endpoint.token:
Token is used to provide a per-request ACL token which overrides the agent's default token

--providers.consulcatalog.exposedbydefault:
Expose containers by default. (Default: true)

--providers.consulcatalog.prefix:
Prefix for consul service tags. Default 'traefik' (Default: traefik)

--providers.consulcatalog.refreshinterval:
Interval for check Consul API. Default 100ms (Default: 15)

--providers.consulcatalog.requireconsistent:
Forces the read to be fully consistent. (Default: false)

--providers.consulcatalog.stale:
Use stale consistency for catalog reads. (Default: false)

--providers.docker:
Enable Docker backend with default settings. (Default: false)

--providers.docker.constraints:
Constraints is an expression that Traefik matches against the container's labels to determine whether to create any route for that container.

--providers.docker.defaultrule:
Default rule. (Default: Host(`{{ normalize .Name }}`))

--providers.docker.endpoint:
Docker server endpoint. Can be a tcp or a unix socket endpoint. (Default: unix:///var/run/docker.sock)

--providers.docker.exposedbydefault:
Expose containers by default. (Default: true)

--providers.docker.network:
Default Docker network used.

--providers.docker.swarmmode:
Use Docker on Swarm Mode. (Default: false)

--providers.docker.swarmmoderefreshseconds:
Polling interval for swarm mode. (Default: 15)

--providers.docker.tls.ca:
TLS CA

--providers.docker.tls.caoptional:
TLS CA.Optional (Default: false)

--providers.docker.tls.cert:
TLS cert

--providers.docker.tls.insecureskipverify:
TLS insecure skip verify (Default: false)

--providers.docker.tls.key:
TLS key

--providers.docker.usebindportip:
Use the ip address from the bound port, rather than from the inner network. (Default: false)

--providers.docker.watch:
Watch Docker Swarm events. (Default: true)

--providers.etcd:
Enable Etcd backend with default settings. (Default: false)

--providers.etcd.endpoints:
KV store endpoints (Default: 127.0.0.1:2379)

--providers.etcd.password:
KV Password

--providers.etcd.rootkey:
Root key used for KV store (Default: traefik)

--providers.etcd.tls.ca:
TLS CA

--providers.etcd.tls.caoptional:
TLS CA.Optional (Default: false)

--providers.etcd.tls.cert:
TLS cert

--providers.etcd.tls.insecureskipverify:
TLS insecure skip verify (Default: false)

--providers.etcd.tls.key:
TLS key

--providers.etcd.username:
KV Username

--providers.file.debugloggeneratedtemplate:
Enable debug logging of generated configuration template. (Default: false)

--providers.file.directory:
Load dynamic configuration from one or more .toml or .yml files in a directory.

--providers.file.filename:
Load dynamic configuration from a file.

--providers.file.watch:
Watch provider. (Default: true)

--providers.kubernetescrd:
Enable Kubernetes backend with default settings. (Default: false)

--providers.kubernetescrd.certauthfilepath:
Kubernetes certificate authority file path (not needed for in-cluster client).

--providers.kubernetescrd.disablepasshostheaders:
Kubernetes disable PassHost Headers. (Default: false)

--providers.kubernetescrd.endpoint:
Kubernetes server endpoint (required for external cluster client).

--providers.kubernetescrd.ingressclass:
Value of kubernetes.io/ingress.class annotation to watch for.

--providers.kubernetescrd.labelselector:
Kubernetes label selector to use.

--providers.kubernetescrd.namespaces:
Kubernetes namespaces.

--providers.kubernetescrd.throttleduration:
Ingress refresh throttle duration (Default: 0)

--providers.kubernetescrd.token:
Kubernetes bearer token (not needed for in-cluster client).

--providers.kubernetesingress:
Enable Kubernetes backend with default settings. (Default: false)

--providers.kubernetesingress.certauthfilepath:
Kubernetes certificate authority file path (not needed for in-cluster client).

--providers.kubernetesingress.disablepasshostheaders:
Kubernetes disable PassHost Headers. (Default: false)

--providers.kubernetesingress.endpoint:
Kubernetes server endpoint (required for external cluster client).

--providers.kubernetesingress.ingressclass:
Value of kubernetes.io/ingress.class annotation to watch for.

--providers.kubernetesingress.ingressendpoint.hostname:
Hostname used for Kubernetes Ingress endpoints.

--providers.kubernetesingress.ingressendpoint.ip:
IP used for Kubernetes Ingress endpoints.

--providers.kubernetesingress.ingressendpoint.publishedservice:
Published Kubernetes Service to copy status from.

--providers.kubernetesingress.labelselector:
Kubernetes Ingress label selector to use.

--providers.kubernetesingress.namespaces:
Kubernetes namespaces.

--providers.kubernetesingress.throttleduration:
Ingress refresh throttle duration (Default: 0)

--providers.kubernetesingress.token:
Kubernetes bearer token (not needed for in-cluster client).

--providers.marathon:
Enable Marathon backend with default settings. (Default: false)

--providers.marathon.basic.httpbasicauthuser:
Basic authentication User.

--providers.marathon.basic.httpbasicpassword:
Basic authentication Password.

--providers.marathon.constraints:
Constraints is an expression that Traefik matches against the application's labels to determine whether to create any route for that application.

--providers.marathon.dcostoken:
DCOSToken for DCOS environment, This will override the Authorization header.

--providers.marathon.defaultrule:
Default rule. (Default: Host(`{{ normalize .Name }}`))

--providers.marathon.dialertimeout:
Set a dialer timeout for Marathon. (Default: 5)

--providers.marathon.endpoint:
Marathon server endpoint. You can also specify multiple endpoint for Marathon. (Default: http://127.0.0.1:8080)

--providers.marathon.exposedbydefault:
Expose Marathon apps by default. (Default: true)

--providers.marathon.forcetaskhostname:
Force to use the task's hostname. (Default: false)

--providers.marathon.keepalive:
Set a TCP Keep Alive time. (Default: 10)

--providers.marathon.respectreadinesschecks:
Filter out tasks with non-successful readiness checks during deployments. (Default: false)

--providers.marathon.responseheadertimeout:
Set a response header timeout for Marathon. (Default: 60)

--providers.marathon.tls.ca:
TLS CA

--providers.marathon.tls.caoptional:
TLS CA.Optional (Default: false)

--providers.marathon.tls.cert:
TLS cert

--providers.marathon.tls.insecureskipverify:
TLS insecure skip verify (Default: false)

--providers.marathon.tls.key:
TLS key

--providers.marathon.tlshandshaketimeout:
Set a TLS handshake timeout for Marathon. (Default: 5)

--providers.marathon.trace:
Display additional provider logs. (Default: false)

--providers.marathon.watch:
Watch provider. (Default: true)

--providers.providersthrottleduration:
Backends throttle duration: minimum duration between 2 events from providers before applying a new configuration. It avoids unnecessary reloads if multiples events are sent in a short amount of time. (Default: 0)

--providers.rancher:
Enable Rancher backend with default settings. (Default: false)

--providers.rancher.constraints:
Constraints is an expression that Traefik matches against the container's labels to determine whether to create any route for that container.

--providers.rancher.defaultrule:
Default rule. (Default: Host(`{{ normalize .Name }}`))

--providers.rancher.enableservicehealthfilter:
Filter services with unhealthy states and inactive states. (Default: true)

--providers.rancher.exposedbydefault:
Expose containers by default. (Default: true)

--providers.rancher.intervalpoll:
Poll the Rancher metadata service every 'rancher.refreshseconds' (less accurate). (Default: false)

--providers.rancher.prefix:
Prefix used for accessing the Rancher metadata service. (Default: latest)

--providers.rancher.refreshseconds:
Defines the polling interval in seconds. (Default: 15)

--providers.rancher.watch:
Watch provider. (Default: true)

--providers.redis:
Enable Redis backend with default settings. (Default: false)

--providers.redis.endpoints:
KV store endpoints (Default: 127.0.0.1:6379)

--providers.redis.password:
KV Password

--providers.redis.rootkey:
Root key used for KV store (Default: traefik)

--providers.redis.tls.ca:
TLS CA

--providers.redis.tls.caoptional:
TLS CA.Optional (Default: false)

--providers.redis.tls.cert:
TLS cert

--providers.redis.tls.insecureskipverify:
TLS insecure skip verify (Default: false)

--providers.redis.tls.key:
TLS key

--providers.redis.username:
KV Username

--providers.rest:
Enable Rest backend with default settings. (Default: false)

--providers.rest.insecure:
Activate REST Provider directly on the entryPoint named traefik. (Default: false)

--providers.zookeeper:
Enable ZooKeeper backend with default settings. (Default: false)

--providers.zookeeper.endpoints:
KV store endpoints (Default: 127.0.0.1:2181)

--providers.zookeeper.password:
KV Password

--providers.zookeeper.rootkey:
Root key used for KV store (Default: traefik)

--providers.zookeeper.tls.ca:
TLS CA

--providers.zookeeper.tls.caoptional:
TLS CA.Optional (Default: false)

--providers.zookeeper.tls.cert:
TLS cert

--providers.zookeeper.tls.insecureskipverify:
TLS insecure skip verify (Default: false)

--providers.zookeeper.tls.key:
TLS key

--providers.zookeeper.username:
KV Username

--serverstransport.forwardingtimeouts.dialtimeout:
The amount of time to wait until a connection to a backend server can be established. If zero, no timeout exists. (Default: 30)

--serverstransport.forwardingtimeouts.idleconntimeout:
The maximum period for which an idle HTTP keep-alive connection will remain open before closing itself (Default: 90)

--serverstransport.forwardingtimeouts.responseheadertimeout:
The amount of time to wait for a server's response headers after fully writing the request (including its body, if any). If zero, no timeout exists. (Default: 0)

--serverstransport.insecureskipverify:
Disable SSL certificate verification. (Default: false)

--serverstransport.maxidleconnsperhost:
If non-zero, controls the maximum idle (keep-alive) to keep per-host. If zero, DefaultMaxIdleConnsPerHost is used (Default: 0)

--serverstransport.rootcas:
Add cert file for self-signed certificate.

--tracing:
OpenTracing configuration. (Default: false)

--tracing.datadog:
Settings for Datadog. (Default: false)

--tracing.datadog.bagageprefixheadername:
Specifies the header name prefix that will be used to store baggage items in a map.

--tracing.datadog.debug:
Enable Datadog debug. (Default: false)

--tracing.datadog.globaltag:
Key:Value tag to be set on all the spans.

--tracing.datadog.localagenthostport:
Set datadog-agent's host:port that the reporter will used. (Default: localhost:8126)

--tracing.datadog.parentidheadername:
Specifies the header name that will be used to store the parent ID.

--tracing.datadog.prioritysampling:
Enable priority sampling. When using distributed tracing, this option must be enabled in order to get all the parts of a distributed trace sampled. (Default: false)

--tracing.datadog.samplingpriorityheadername:
Specifies the header name that will be used to store the sampling priority.

--tracing.datadog.traceidheadername:
Specifies the header name that will be used to store the trace ID.

--tracing.elastic:
Settings for Elastic. (Default: false)

--tracing.elastic.secrettoken:
Set the token used to connect to Elastic APM Server.

--tracing.elastic.serverurl:
Set the URL of the Elastic APM server.

--tracing.elastic.serviceenvironment:
Set the name of the environment Traefik is deployed in, e.g. 'production' or 'staging'.

--tracing.haystack:
Settings for Haystack. (Default: false)

--tracing.haystack.baggageprefixheadername:
Specifies the header name prefix that will be used to store baggage items in a map.

--tracing.haystack.globaltag:
Key:Value tag to be set on all the spans.

--tracing.haystack.localagenthost:
Set haystack-agent's host that the reporter will used. (Default: 127.0.0.1)

--tracing.haystack.localagentport:
Set haystack-agent's port that the reporter will used. (Default: 35000)

--tracing.haystack.parentidheadername:
Specifies the header name that will be used to store the parent ID.

--tracing.haystack.spanidheadername:
Specifies the header name that will be used to store the span ID.

--tracing.haystack.traceidheadername:
Specifies the header name that will be used to store the trace ID.

--tracing.instana:
Settings for Instana. (Default: false)

--tracing.instana.localagenthost:
Set instana-agent's host that the reporter will used.

--tracing.instana.localagentport:
Set instana-agent's port that the reporter will used. (Default: 42699)

--tracing.instana.loglevel:
Set instana-agent's log level. ('error','warn','info','debug') (Default: info)

--tracing.jaeger:
Settings for Jaeger. (Default: false)

--tracing.jaeger.collector.endpoint:
Instructs reporter to send spans to jaeger-collector at this URL.

--tracing.jaeger.collector.password:
Password for basic http authentication when sending spans to jaeger-collector.

--tracing.jaeger.collector.user:
User for basic http authentication when sending spans to jaeger-collector.

--tracing.jaeger.gen128bit:
Generate 128 bit span IDs. (Default: false)

--tracing.jaeger.localagenthostport:
Set jaeger-agent's host:port that the reporter will used. (Default: 127.0.0.1:6831)

--tracing.jaeger.propagation:
Which propagation format to use (jaeger/b3). (Default: jaeger)

--tracing.jaeger.samplingparam:
Set the sampling parameter. (Default: 1.000000)

--tracing.jaeger.samplingserverurl:
Set the sampling server url. (Default: http://localhost:5778/sampling)

--tracing.jaeger.samplingtype:
Set the sampling type. (Default: const)

--tracing.jaeger.tracecontextheadername:
Set the header to use for the trace-id. (Default: uber-trace-id)

--tracing.servicename:
Set the name for this service. (Default: traefik)

--tracing.spannamelimit:
Set the maximum character limit for Span names (default 0 = no limit). (Default: 0)

--tracing.zipkin:
Settings for Zipkin. (Default: false)

--tracing.zipkin.httpendpoint:
HTTP Endpoint to report traces to. (Default: http://localhost:9411/api/v2/spans)

--tracing.zipkin.id128bit:
Use Zipkin 128 bit root span IDs. (Default: true)

--tracing.zipkin.samespan:
Use Zipkin SameSpan RPC style traces. (Default: false)

--tracing.zipkin.samplerate:
The rate between 0.0 and 1.0 of requests to trace. (Default: 1.000000)