Demo
Demo

Knowledge base

temporary-expires verified

How long held mail waits before returning

in the configuration this is a linetemporary-expires: …

Time to live on a temporary queue: after it expires, mail held there because of throttling or a pause goes back to the sending queue.

Values

Values
positive integer
applying
restart required
where it can be set
in the config file · with a startup flag · as an environment variable

In detail

Added in 5.16.0 — the only documented change in the 5.16 line, which makes it the newest thing in this product. Before it, held mail waited on the queue's own terms; now there is a ceiling, and after it the message is retried whether or not the condition that held it has gone away. That is a real trade. Too short, and mail returns into the same limit that just pushed it aside, burning attempts against a domain that is not ready. Too long, and mail sits held after the problem has passed. Hub's warm-up plans should be aware of it: an address being held back by a throttle is not idle, it is on a timer nobody set deliberately.

What happens if you get it wrong

Set very low.Held mail returns immediately into the condition that held it, consuming delivery attempts against a domain that is still refusing them.inference · inference
Left long on a node with aggressive throttles.Temporary queues accumulate; the per-domain picture they give becomes a list of historical problems rather than current ones.inference · inference