Upgrading to Kestra 0.20.0: KV Changes, Kafka Restore & Config Updates

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.

0.20.0

Deprecated features and migration guides for 0.20.0 and onwards.

Cluster Monitoring: SUPER_ADMIN

Cluster Monitoring permissions update in Kestra 0.20.0. Access to the Instance/Cluster Monitoring page now requires SUPER_ADMIN privileges.

Conditions Renamed

Condition renaming in Kestra 0.20.0. Update your flows to use the new condition names (e.g., ExecutionStatus instead of ExecutionStatusCondition).

Custom Plugins: namespace Param

Custom Plugin migration for Kestra 0.20.0. Update plugins to handle the mandatory namespace parameter in internal storage methods.

Elasticsearch Indexer Embedded

Elasticsearch Indexer changes in Kestra 0.20.0 (Enterprise). The webserver now embeds the indexer by default for Kafka backends, simplifying deployment.

KV Cross-Namespace Permissions

KV Function security update in Kestra 0.20.0. Ensure proper namespace access permissions when retrieving Key-Value pairs from different namespaces.

Restore Kafka Queue

Kafka Queue Restore for Kestra 0.20.0 (Enterprise). Instructions to run the sys-ee restore-queue command to sync flow source code for plugin defaults.

Mail & Secret Manager Config

Server Configuration updates in Kestra 0.20.0. Mail service config moved to kestra.ee and Secret Manager configuration is now mandatory.

Username → Email

Usernames replaced by emails in Kestra 0.20.0 (Enterprise). Run the migration command to update user identifiers to valid email addresses.

Worker Group Fallback Behavior

Worker Group Fallback changes in Kestra 0.20.0 (Enterprise). Configure fallback: FAIL to retain previous behavior when no workers are available in a group.

Was this page helpful?