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.mdto anykestra.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 pauses. Requests to create or restart executions are held until maintenance ends, and running executions don’t move to their next task. Retry, pause, and SLA timers also wait, as do the liveness checks that detect unresponsive servers. Everything resumes when you exit maintenance mode.
- 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?