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.

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.

Enter maintenance mode

Go to Instance Owner → Instance → Services and click Enter maintenance mode in the top-right corner. A confirmation prompt explains what will happen before the transition begins. To exit, click the same button and confirm you want to return to a live state.

Was this page helpful?