Skip to content

Commit c373bb8

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 67403ea commit c373bb8

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
@@ -111,12 +111,14 @@ two network cards, or a site-local address and a local address. Defaults to
111111

112112
`network.publish_host`::
113113

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

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

0 commit comments

Comments
 (0)