From fbb91208942256d2b79cd7d8f3871e103491c2a4 Mon Sep 17 00:00:00 2001 From: Sarah Christoff Date: Thu, 30 Jan 2020 12:52:58 -0600 Subject: [PATCH] [docs] Clarify retry-join (#7078) --- website/source/docs/agent/options.html.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/website/source/docs/agent/options.html.md b/website/source/docs/agent/options.html.md index 1045481580..51d8ce4502 100644 --- a/website/source/docs/agent/options.html.md +++ b/website/source/docs/agent/options.html.md @@ -315,8 +315,10 @@ The options below are all specified on the command-line. -* `-retry-join` - Similar to [`-join`](#_join) but allows retrying a join if the - first attempt fails. This is useful for cases where you know the address will +* `-retry-join` - Similar to [`-join`](#_join) but allows retrying a join until + it is successful. Once it joins successfully to a member in a list of members + it will never attempt to join again. Agents will then solely maintain their + membership via gossip. This is useful for cases where you know the address will eventually be available. This option can be specified multiple times to specify multiple agents to join. The value can contain IPv4, IPv6, or DNS addresses. In Consul 1.1.0 and later this can be set to a