diff --git a/website/source/docs/agent/configuration/consul.html.md b/website/source/docs/agent/configuration/consul.html.md index 63bade4f5..2d79ff540 100644 --- a/website/source/docs/agent/configuration/consul.html.md +++ b/website/source/docs/agent/configuration/consul.html.md @@ -41,6 +41,12 @@ cluster with zero configuration. To put it another way: if you have a Consul agent running on the same host as the Nomad agent with the default configuration, Nomad will automatically connect and configure with Consul. +An important requirement is that each Nomad agent talks to a unique Consul +agent. Nomad agents should be configured to talk to Consul agents and not +Consul servers. If you are observing flapping services, you may have have +multiple Nomad agents talking to the same Consul agent. As such avoid +configuring Nomad to talk to Consul via DNS such as consul.service.consul + ## `consul` Parameters - `address` `(string: "127.0.0.1:8500")` - Specifies the address to the local