cluster-address verifiedcriticalWritten by the Hub
Broker used for cluster traffic
in the configuration this is a line
cluster-address: amqp://guest:guest@localhost/AMQP address of the broker over which nodes announce themselves and tell each other to re-read settings; defaults to the same broker that carries the mail.
Values
- Values
amqp://user:pass@host/vhost or amqps://…- Default
amqp://guest:guest@localhost/ · taken from the build- applying
restart required- where it can be set
in the config file · with a startup flag · as an environment variable
In detail
Cluster membership is nothing more than sharing this address and this exchange. There is no registration, no master and no quorum: a node publishes what it is, listens for what others publish, and acts on the control messages it receives. Pointing two groups of nodes at different cluster addresses splits them into two clusters even if they share a database, and pointing them at the same address joins them even if they were never meant to be related.
What happens if you get it wrong
The password contains @ : / % or a space.The address cannot be parsed the way MailerQ builds it, and the broker refuses the login with ACCESS_REFUSED even though the password is correct — percent-escapes are not decoded here.verified by experiment · inference
Nodes are pointed at different cluster addresses.They stop hearing each other's reload messages; settings changes reach only part of the fleet.inference · inference