Spring Cloud Consul

Spring Cloud Consul provides Consul integrations for Spring Boot apps through autoconfiguration and binding to the Spring Environment and other Spring programming model idioms. With a few simple annotations you can quickly enable and configure the common patterns inside your application and build large distributed systems with Hashicorp's Consul. The patterns provided include Service Discovery, Distributed Configuration and Control Bus.

Quick Start
Fork me on GitHub


Spring Cloud Consul features:

  • Service Discovery: instances can be registered with the Consul agent and clients can discover the instances using Spring-managed beans
  • Supports Ribbon, the client side load-balancer via Spring Cloud Netflix
  • Supports Zuul, a dynamic router and filter via Spring Cloud Netflix
  • Distributed Configuration: using the Consul Key/Value store
  • Control Bus: Distributed control events using Consul Events

Quick Start


The recommended way to get started using spring-cloud-consul in your project is with a dependency management system – the snippet below can be copied and pasted into your build. Need help? See our getting started guides on building with Maven and Gradle.

As long as Spring Cloud Consul and the Consul API are on the classpath any Spring Boot application with @EnableDiscoveryClient will try to contact a Consul agent on localhost:8500 (the default values of spring.cloud.consul.host and spring.cloud.consul.port respectively):

public class Application {

  public String home() {
    return "Hello World";

  public static void main(String[] args) {
    SpringApplication.run(Application.class, args);


A local Consul agent must be running. See the Consul agent documentation on how to run an agent.

Sample Projects