2017-05-16 13:28:18 +00:00
# Clustering / High Availability (beta)
2016-09-29 11:49:12 +00:00
2017-09-07 09:16:03 +00:00
This guide explains how to use Træfik in high availability mode.
2017-09-11 17:10:04 +00:00
2017-03-31 04:29:03 +00:00
In order to deploy and configure multiple Træfik instances, without copying the same configuration file on each instance, we will use a distributed Key-Value store.
2016-09-29 11:49:12 +00:00
## Prerequisites
You will need a working KV store cluster.
2017-09-11 17:10:04 +00:00
_(Currently, we recommend [Consul ](https://consul.io ) .)_
2016-09-29 11:49:12 +00:00
## File configuration to KV store migration
2017-03-31 04:29:03 +00:00
We created a special Træfik command to help configuring your Key Value store from a Træfik TOML configuration file.
2017-09-11 17:10:04 +00:00
2016-09-29 11:49:12 +00:00
Please refer to [this section ](/user-guide/kv-config/#store-configuration-in-key-value-store ) to get more details.
2017-03-31 04:29:03 +00:00
## Deploy a Træfik cluster
2016-09-29 11:49:12 +00:00
2017-03-31 04:29:03 +00:00
Once your Træfik configuration is uploaded on your KV store, you can start each Træfik instance.
2017-09-11 17:10:04 +00:00
2017-05-21 12:35:11 +00:00
A Træfik cluster is based on a manager/worker model.
2017-09-11 17:10:04 +00:00
2017-08-26 10:12:44 +00:00
When starting, Træfik will elect a manager.
If this instance fails, another manager will be automatically elected.
