This page is about Caddy 1 and will stay here forever.

User Guide


This plugin allows Caddy to use Consul Key/Value store to share TLS data across multiple Caddy instances in a cluster.

Full documentation


Enable Consul cluster support
# enable Consul clustering plugin export CADDY_CLUSTERING="consul" # set k/v path prefix export CADDY_CLUSTERING_CONSUL_PREFIX="caddy/tls" # set AES key to use for encryption (32 Bytes) export CADDY_CLUSTERING_CONSUL_AESKEY="consultls-1234567890-caddytls-32" # set Consul address export CONSUL_HTTP_ADDR="" # set Consul access token export CONSUL_HTTP_TOKEN=""

The plugin is configured using environment variables. Be sure to enable Consul cluster support setting CADDY_CLUSTERING to "consul".

Related Links

Access the full documentation for this plugin off-site:

Plugin Help

Get help from the maintainers of the consul plugin:

Plugin Website

Visit consul's website for more information:

Plugin Author: Peter Teich
Last Updated: 12 Feb 2019, 3:25 PM
This plugin is independent of the Caddy project and is not endorsed or maintained by Caddy developers. Use at your own risk. Do not file issues for this plugin on Caddy's bug tracker.