Monitor Services, Handle Upgrades, and Manage Global Settings
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.

The Instance Owner console gives you a centralized view of your Kestra deployment’s health along with controls for upgrades, maintenance, and user notifications.

System overview

Inside the Instance Owner console, the Instance section covers service health, kill switches, announcements, maintenance mode, and plugin versioning. The System Overview tab gives a high-level snapshot of your instance’s operational status, including license validity, usage statistics, and installed secrets and storage plugins.

Services

Kestra tracks the health of critical components, including:

  • Workers: Execute tasks.
  • Schedulers: Trigger workflows.
  • Executors: Manage task execution.
  • Webservers: Host the UI and API.

Each service displays its state, hostname, server type, version, start date, and last health check date. Click a service to see per-instance details for debugging: session timeout, heartbeat interval, last heartbeat, and termination grace period.

Service states

  • RUNNING — service is active and healthy.
  • MAINTENANCE — intentionally paused; executions are blocked until resumed.
  • DISCONNECTED — lost a required dependency (e.g., DB/queue) and may recover or shut down.
  • TERMINATING — shutting down; tries to drain work before stopping.
  • TERMINATED_GRACEFULLY / TERMINATED_FORCED — shutdown completed (clean or forced), moves to NOT_RUNNING.
  • NOT_RUNNING / INACTIVE — post-shutdown, final states reported in the UI.

Additional tabs include Configuration for port details, Metrics such as CPU usage and executor thread count, and an Events Timeline showing the service’s full lifecycle.

Announcements

Announcements let you broadcast in-app banners to notify users about planned maintenance, incidents, or other events. Each announcement has a message, a severity type (INFO, WARNING, or ERROR), and a start and end date.

Maintenance mode

Maintenance mode pauses the platform broadly: new executions are queued and running ones are allowed to finish before services stop. Combine it with an Announcement so users see a banner while the platform drains.

Versioned Plugins

Versioned Plugins lists all plugins installed on the instance. Upgrade, install, or uninstall plugins without restarting Kestra.

Instance Owner

Use the Instance Owner console in Kestra Enterprise to manage tenants, instance-wide IAM, infrastructure, and governance from a single interface.

Announcements

Broadcast messages with Kestra Announcements. Create in-app banners to notify users about maintenance, updates, or important system information.

Kill Switch

Use Kill Switch in Kestra Enterprise to immediately kill, cancel, or ignore executions by scope, with scheduling, audit logs, and in-app banners.

Maintenance Mode

Safely upgrade with Kestra Maintenance Mode. Pause new executions while allowing running tasks to complete for seamless system updates.

Versioned Plugins

Run multiple versions of any plugin side-by-side across your Kestra instance. Build, test, and ship plugin updates from a jar file without disrupting existing flows — and upgrade on your own timeline.

Was this page helpful?