Skip to content

Clustering / High Availability (beta)

This guide explains how to use Traefik in high availability mode.

In order to deploy and configure multiple Traefik instances, without copying the same configuration file on each instance, we will use a distributed Key-Value store.


You will need a working KV store cluster. (Currently, we recommend Consul .)

File configuration to KV store migration

We created a special Traefik command to help configuring your Key Value store from a Traefik TOML configuration file.

Please refer to this section to get more details.

Deploy a Traefik cluster

Once your Traefik configuration is uploaded on your KV store, you can start each Traefik instance.

A Traefik cluster is based on a manager/worker model.

When starting, Traefik will elect a manager. If this instance fails, another manager will be automatically elected.

Traefik cluster and Let's Encrypt

In cluster mode, ACME certificates have to be stored in a KV Store entry.

Thanks to the Traefik cluster mode algorithm (based on the Raft Consensus Algorithm), only one instance will contact Let's encrypt to solve the challenges.

The others instances will get ACME certificate from the KV Store entry.