Knowledge base

rabbitmq-outbox verifiedcriticalWritten by the Hub

Routing key for mail to be sent

in the configuration this is a linerabbitmq-outbox: outbox

Routing key used when a message is published for sending — and, on a stock configuration, also the name of the queue the engine reads.

Values

Values
any routing key
Default
outbox · 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

Everything that enters MailerQ ends up published under this key: messages accepted by the SMTP server, picked up from the spool, injected through REST, and messages coming back from the delay ladder after a retry wait. Because the stock config leaves rabbitmq-queue unset, changing this name changes what the engine consumes as well — verified on the stand, where renaming it created a new queue with all ten consumers and a fresh delay ladder, while the old queues stayed behind empty and unread.

What happens if you get it wrong

Renamed while rabbitmq-inbox still points at the old name.Mail accepted over SMTP is published to a queue nobody reads. Observed on the stand: the engine moved to the new queue, the intake key stayed on the old one.verified by experiment · inference
Renamed on a node with mail in flight.The old queue and its whole delay ladder remain, holding messages that will never be picked up.verified by experiment · inference