Werk #18263: messaging: correctly start RabbitMQ in case of ipv6 disabled

Component Other components
Title messaging: correctly start RabbitMQ in case of ipv6 disabled
Date Jul 30, 2025
Level Trivial Change
Class Bug Fix
Compatibility Compatible - no manual interaction needed
Checkmk versions & editions
2.5.0b1
Not yet released
Checkmk Raw (CRE), Checkmk Enterprise (CEE), Checkmk Cloud (CCE), Checkmk MSP (CME)
2.4.0p10 Checkmk Raw (CRE), Checkmk Enterprise (CEE), Checkmk Cloud (CCE), Checkmk MSP (CME)

On systems with IPv6 disabled, RabbitMQ was not starting, with an error in the logs similar to this one:

Failed to start Ranch listener {acceptor,{0,0,0,0,0,0,0,1},15672} in
ranch_tcp:listen(#{socket_opts => [{cacerts,'...'},{key,'...'},{cert,'...'},
{ip,{0,0,0,0,0,0,0,1}},{port,15672}]}) for reason eaddrnotavail (can't assign requested address)

From this werk, the management listener IP (localhost) is computed during RabbitMQ restart: '::1' if IPv6 is enabled, '127.0.0.1' if IPv6 is disabled. The default IP list from which RabbitMQ accepts connections (via the AMQP protocol) is also expanded: it was only '::' and now includes '0.0.0.0', ensuring the listeners are running even when IPv6 is disabled.

Please be aware that, if ipv6 is disabled while checkmk is running, a manual restart of rabbitmq will be required, via the command omd restart rabbitmq.

To the list of all Werks