open-vault/website/source/docs/concepts/ha.html.markdown
2015-12-22 21:27:08 +00:00

1.9 KiB

layout page_title sidebar_current description
docs High Availability docs-concepts-ha Vault can be highly available, allowing you to run multiple Vaults to protect against outages.

High Availability Mode (HA)

Vault supports multi-server mode for high availability. This mode protects against outages by running multiple Vault servers. High availability mode is automatically enabled when using a storage backend that supports it.

You can tell if a backend supports high availability mode ("HA") by starting the server and seeing if "(HA available)" is outputted next to the backend information. If it is, then HA will begin happening automatically.

To be highly available, Vault elects a leader and does request forwarding to the leader. Due to this architecture, HA does not enable increased scalability. In general, the bottleneck of Vault is the storage backend itself, not Vault core. For example: to increase scalability of Vault with Consul, you would scale Consul instead of Vault.

In addition to using a backend that supports HA, you have to configure Vault with an advertise address. This is the address that Vault advertises to other Vault servers in the cluster for request forwarding. By default, Vault will use the first private IP address it finds, but you can override this to any address you want.

Backend Support

Currently there are several backends that support high availability mode, including Consul, ZooKeeper and etcd. These may change over time, and the configuration page should be referenced.

The Consul backend is the recommended HA backend, as it is used in production by HashiCorp and its customers with commercial support.

If you're interested in implementing another backend or adding HA support to another backend, we'd love your contributions. Adding HA support requires implementing the physical.HABackend interface for the storage backend.