Consul is a distributed, highly available, and data center aware solution to connect and configure applications across dynamic, distributed infrastructure.
Branch: master
Clone or download
kaitlincarter-hc [Docs] Helm Chart (#5350)
* Updating the Helm chart to include ACL parameter and examples.

* Updates based on feedback.

* Update website/source/docs/platform/k8s/

Co-Authored-By: kaitlincarter-hc <>
Latest commit 193c0b7 Feb 21, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci add nomad int test Jan 28, 2019
.github Remove consul-docs automatic PR review (#5306) Feb 1, 2019
acl New ACLs (#4791) Oct 19, 2018
agent Envoy config cluster (#5308) Feb 19, 2019
api Improve Connect with Prepared Queries (#5291) Feb 4, 2019
bench Gets benchmarks running again and does a rough pass for 0.7.1. Nov 29, 2016
build-support build: fix 'make ui' scripts so that it can handle versions like "v1.… Jan 29, 2019
command Pass a testing.T into NewTestAgent and TestAgent.Start (#5342) Feb 14, 2019
connect Pass a testing.T into NewTestAgent and TestAgent.Start (#5342) Feb 14, 2019
demo demo: Added udp port forwarding May 30, 2018
ipaddr New config parser, HCL support, multiple bind addrs (#3480) Sep 25, 2017
lib connect: tame thundering herd of CSRs on CA rotation (#5228) Jan 22, 2019
logger Fix logfile open filemode (#5354) Feb 15, 2019
sentinel Renames stubs to be more consistent. Nov 30, 2017
service_os Changes made : Jun 29, 2018
snapshot snapshot: read meta.json correctly. (#5193) Jan 8, 2019
terraform terraform: fix formatting of (#4580) Oct 24, 2018
test snapshot: read meta.json correctly. (#5193) Jan 8, 2019
testrpc speed up TestHTTPAPI_MethodNotAllowed_OSS from 11s -> 0.5s (#5268) Jan 25, 2019
testutil testutil: redirect some test agent logs to testing.T.Logf (#5304) Feb 1, 2019
tlsutil agent: honor when ca is set but verify_outgoing is disabled (#4826) Dec 17, 2018
types Removes remoteConsuls in favor of the new router. Mar 16, 2017
ui-v2 ui: Custom version of ember-block-slots compatible with ember 3 (#5245) Jan 30, 2019
ui update ffi to dodge CVE-2018-1000201 (#4670) Sep 14, 2018
vendor Revendor memberlist to Fix #3217 Feb 5, 2019
version Putting source back into Dev Mode Jan 28, 2019
watch Pass a testing.T into NewTestAgent and TestAgent.Start (#5342) Feb 14, 2019
website [Docs] Helm Chart (#5350) Feb 21, 2019
.dockerignore Update the scripting Jun 15, 2018
.gitignore merge feedback: fix typos; actually use deliverLatest added previousl… Oct 10, 2018
.travis.yml travis: enable branch builds for f-acl-ux and stop doing them for f-e… Feb 13, 2019 Update Feb 19, 2019
GNUmakefile CA Provider Plugins (#4751) Jan 7, 2019 docs: correct link to top level agent package (#4750) Oct 4, 2018
LICENSE Initial commit Nov 4, 2013 add copyright notice file Jul 9, 2018 Contribution guide (#4704) Oct 5, 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:


Thank you for your interest in contributing! Please refer to for guidance.