Difficulty: beginner
Estimated Time: 2 minutes

This course will show you how to set-up a 3 node Consul Cluster.

The Consul cluster may be used to host Docker Swarm status, or a Hashicorp Vault Secure storage.

Consul may also be used to store app configurations.

In this scenario, we explored how to launch a Consul cluster running as Docker containers. Once running, we simulated a node failure and how to identify the health via the CLI and UI.

In future scenarios, we'll explore how to Consul to manage API and DNS requests.

Docker Consul Cluster

Step 1 of 4

Step 1 - Start Consul Agent

This is your first step.

Start Consul Agent

This is an example of creating a scenario and running a command

To start, we'll launch a primary Consul agent which others will connect too. Each of these agents will run as separate containers on the same node. In production, each of the containers would run on different machines.

The agents will form the initial cluster and Consul Quorum for ensuring data stored is consistent and remains available after outages.

Task: Launch Agent

To start an launch we use the official Docker image and provide the arguments agent -dev. To make the UI accessible we tell Consul to bind to the public IP instead of The UI runs on port 8500 which we map to the host.

docker run -d --name=c1 -p 8500:8500 consul agent -dev -client= -bind=

Because we haven't told this agent to join a cluster, it will create one for us. In the next step we'll add additional agents.