Skip to main content
This hook runs only when the runtime image reference changes. Use it for setup that is lost when the container image changes, such as packages installed into non-persisted system paths.

File path

Create this file:

When to use it

This hook is useful when you want to:
  • reinstall system packages
  • restore tools that are not part of your persisted home directory
  • rerun one-time setup after a runtime update

Timeout

If the hook fails or times out, startup continues. The image ref is not marked as completed, so the hook retries on the next container start.

Example