max-attempts verifiedimportantWritten by the Hub
Attempt ceiling
in the configuration this is a line
max-attempts: 100How many delivery attempts a message may consume before it is given up on.
Values
- Values
positive integer, or 0 for unlimited- Default
100 · 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
A hundred in the package; the documentation says zero, meaning unlimited. That is a substantial difference in behaviour dressed as a documentation slip: one configuration gives up, the other never does, and only one of them is what your node actually has. In practice the ceiling is rarely what ends a message — the deadline or the retry list runs out first — which is exactly why it goes unnoticed until the day someone raises the deadline.
What happens if you get it wrong
Set to 0 as the documentation suggests.Messages are retried without limit until the deadline; on a permanently broken destination the node spends the whole day on mail that will never land.from the documentation · inference