Skip to content

Commit 7f161ef

Browse files
committed
Add doc note regarding explicit publish host
This commit adds a note to the docs regarding explicilty setting a publish host if the network.host setting results in multiple bind addresses. Relates #25496
1 parent 59096e0 commit 7f161ef

File tree

1 file changed

+8
-6
lines changed

1 file changed

+8
-6
lines changed

docs/reference/modules/network.asciidoc

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -116,12 +116,14 @@ two network cards, or a site-local address and a local address. Defaults to
116116

117117
`network.publish_host`::
118118

119-
The publish host is the single interface that the node advertises to other
120-
nodes in the cluster, so that those nodes can connect to it. Currently an
121-
elasticsearch node may be bound to multiple addresses, but only publishes one.
122-
If not specified, this defaults to the ``best'' address from
123-
`network.host`, sorted by IPv4/IPv6 stack preference, then by
124-
reachability.
119+
The publish host is the single interface that the node advertises to other nodes
120+
in the cluster, so that those nodes can connect to it. Currently an
121+
Elasticsearch node may be bound to multiple addresses, but only publishes one.
122+
If not specified, this defaults to the ``best'' address from `network.host`,
123+
sorted by IPv4/IPv6 stack preference, then by reachability. If you set a
124+
`network.host` that results in multiple bind addresses yet rely on a specific
125+
address for node-to-node communication, you should explicitly set
126+
`network.publish_host`.
125127

126128
Both of the above settings can be configured just like `network.host` -- they
127129
accept IP addresses, host names, and

0 commit comments

Comments
 (0)