Pause New Executions Safely During System Upgrades

For the complete documentation index, see llms.txt. For a full content snapshot, see llms-full.txt. Append .md to any kestra.io/docs/* URL for plain Markdown.

Available on:Enterprise EditionCloud

Prepare your Kestra instance for maintenance or migration.

How maintenance mode works

When activated:

  • The executor stops processing new executions and queues them automatically.
  • Workers finish their current tasks without picking up new ones.
  • The web server and scheduler remain active — no requests are lost.

Enabling maintenance mode

Maintenance mode is enabled from Instance Owner → Instance → Services. A confirmation prompt appears before the transition begins. The same button exits maintenance mode and returns the instance to a live state.

Was this page helpful?