Traefik & Consul Catalog

A Story of Tags, Services & Instances

Attach tags to your services and let Traefik do the rest!

Configuration Examples

Configuring Consul Catalog & Deploying / Exposing Services

Enabling the consul catalog provider

File (YAML)

providers:
  consulCatalog: {}

File (TOML)

[providers.consulCatalog]

CLI

--providers.consulcatalog=true

Attaching tags to services

- traefik.http.routers.my-router.rule=Host(`example.com`)

Routing Configuration

See the dedicated section in routing.

Provider Configuration

refreshInterval

Optional, Default=15s

Defines the polling interval.

File (YAML)

providers:
  consulCatalog:
    refreshInterval: 30s
    # ...

File (TOML)

[providers.consulCatalog]
  refreshInterval = "30s"
  # ...

CLI

--providers.consulcatalog.refreshInterval=30s
# ...

prefix

required, Default="traefik"

The prefix for Consul Catalog tags defining Traefik labels.

File (YAML)

providers:
  consulCatalog:
    prefix: test
    # ...

File (TOML)

[providers.consulCatalog]
  prefix = "test"
  # ...

CLI

--providers.consulcatalog.prefix=test
# ...