Model config: `automatically-retry-hooks`

See also: List of model configuration keys

This document describes the automatically-retry-hooks model configuration key.

Key Type Default Valid values Purpose
automatically-retry-hooks bool true Determines whether the uniter should automatically retry failed hooks.

Juju retries failed hooks automatically using an exponential backoff algorithm. They will be retried after 5, 10, 20, 40 seconds up to a period of 5 minutes, and then every 5 minutes. The logic behind this is that some hook errors are caused by timing issues or the temporary unavailability of other applications - automatic retry enables the Juju model to heal itself without troubling the user.

However, in some circumstances, such as debugging charms, this behaviour can be distracting and unwelcome. For this reason, it is possible to set the automatically-retry-hooks option to ‘false’ to disable this behaviour. In this case, users will have to manually retry any hook which fails, using the command above, as with earlier versions of Juju.

Even with the automatic retry enabled, it is still possible to use the juju resolved unit-name/# command to retry manually.