Consul is a distributed, highly available, and data center aware solution to connect and configure applications across dynamic, distributed infrastructure.
Clone or download
johncowen ui: Layout fix. Small padding additions to tables (#4701)
1. The 'Services' header need to be knocked ot the right slightly to line
up properly with the service name when there are no external source
2. Add a single space between ServiceName and ServiceID on the Node >
[Services] tab table.
Latest commit 96508e5 Sep 21, 2018
Failed to load latest commit information.
.github/ISSUE_TEMPLATE github: some minor changes to issue templates (#4521) Aug 28, 2018
acl Rewrite all of acl_test.go Jul 25, 2018
agent do not bootstrap with non voters Sep 20, 2018
api Improve resilience of api pkg tests (#4676) Sep 18, 2018
bench Gets benchmarks running again and does a rough pass for 0.7.1. Nov 29, 2016
build-support Detect correct GOOS/ARCH for copying binary with build_consul_local Sep 10, 2018
command Exit with error code 1 when failing to list DCs (#4583) Sep 12, 2018
connect Connect: Verify the leaf cert to determine its readiness. (#4540) Sep 7, 2018
demo demo: Added udp port forwarding May 30, 2018
ipaddr New config parser, HCL support, multiple bind addrs (#3480) Sep 25, 2017
lib Refactor to use embedded struct. Jun 25, 2018
logger Adds a new command line flag -log-file for file based logging. (#4581) Aug 29, 2018
sentinel Renames stubs to be more consistent. Nov 30, 2017
service_os Changes made : Jun 29, 2018
snapshot Removes timeout when restoring snapshots. Dec 13, 2017
terraform Spelling (#3958) Mar 19, 2018
test Update test certificates that expire this year to be way in the future May 12, 2018
testrpc Bugfix: Use "%#v" when formatting structs (#4600) Aug 28, 2018
testutil Improve resilience of api pkg tests (#4676) Sep 18, 2018
tlsutil 🐛 Formatting changes only; add missing trailing commas Mar 15, 2018
types Removes remoteConsuls in favor of the new router. Mar 16, 2017
ui-v2 ui: Layout fix. Small padding additions to tables (#4701) Sep 21, 2018
ui update ffi to dodge CVE-2018-1000201 (#4670) Sep 14, 2018
vendor Update Raft Vendoring (#4539) Sep 6, 2018
version Putting source back into Dev Mode Sep 13, 2018
watch Fixed flaky watch tests (#4595) Sep 4, 2018
website fix typo on connect/index (#4681) Sep 17, 2018
.dockerignore Update the scripting Jun 15, 2018
.gitignore Update .gitignore - ignore some macos fs event notification stuff May 24, 2018
.travis.yml Enable CI on f-envoy feature branch Sep 6, 2018 Update Sep 20, 2018
GNUmakefile Improve resilience of api pkg tests (#4676) Sep 18, 2018 Spelling (#3958) Mar 19, 2018
LICENSE Initial commit Nov 4, 2013 add copyright notice file Jul 9, 2018 Update required golang version in Readme Sep 12, 2018
Vagrantfile Adds a basic Linux Vagrant setup, stolen from Nomad. Oct 6, 2017
main.go Added Side Effect import for Windows Service Jun 18, 2018
main_test.go Adding basic CLI infrastructure Dec 19, 2013

Consul Build Status Join the chat at

Consul is a tool for service discovery and configuration. Consul is distributed, highly available, and extremely scalable.

Consul provides several key features:

  • Service Discovery - Consul makes it simple for services to register themselves and to discover other services via a DNS or HTTP interface. External services such as SaaS providers can be registered as well.

  • Health Checking - Health Checking enables Consul to quickly alert operators about any issues in a cluster. The integration with service discovery prevents routing traffic to unhealthy hosts and enables service level circuit breakers.

  • Key/Value Storage - A flexible key/value store enables storing dynamic configuration, feature flagging, coordination, leader election and more. The simple HTTP API makes it easy to use anywhere.

  • Multi-Datacenter - Consul is built to be datacenter aware, and can support any number of regions without complex configuration.

  • Service Segmentation - Consul Connect enables secure service-to-service communication with automatic TLS encryption and identity-based authorization.

Consul runs on Linux, Mac OS X, FreeBSD, Solaris, and Windows. A commercial version called Consul Enterprise is also available.

Please note: We take Consul's security and our users' trust very seriously. If you believe you have found a security issue in Consul, please responsibly disclose by contacting us at

Quick Start

An extensive quick start is viewable on the Consul website:


Full, comprehensive documentation is viewable on the Consul website:

Developing Consul

If you wish to work on Consul itself, you'll first need Go installed (version 1.10+ is required). Make sure you have Go properly installed, including setting up your GOPATH.

Next, clone this repository into $GOPATH/src/ and then just type make. In a few moments, you'll have a working consul executable:

$ make
$ bin/consul

Note: make will build all os/architecture combinations. Set the environment variable CONSUL_DEV=1 to build it just for your local machine's os/architecture, or use make dev.

Note: make will also place a copy of the binary in the first part of your $GOPATH.

You can run tests by typing make test. The test suite may fail if over-parallelized, so if you are seeing stochastic failures try GOTEST_FLAGS="-p 2 -parallel 2" make test.

If you make any changes to the code, run make format in order to automatically format the code according to Go standards.


Consul currently uses govendor for vendoring and vendorfmt for formatting vendor.json to a more merge-friendly "one line per package" format.