​Migration ​Guide

Migrate to the latest version of Kestra.

Script tasks moved to dedicated plugins

Script tasks included in the core plugin have been deprecated in 0.11.0 and moved to dedicated plugins.

Inputs Name

The name property of inputs are deprecated in favor of id for consistency with the rest of the flow configuration.

Deprecation of Listeners

Listeners are deprecated and disabled by default starting from the 0.12.0 release. Please use Flow triggers instead.

Deprecation of LocalFiles and outputDir

Migrate from LocalFiles and outputDir to inputFiles and outputFiles.

Migration to Micronaut 4.3

Kestra 0.15.0 has been migrated to Micronaut 4.3 for improved security. This page explains how to make your custom plugins compatible with this new version.

Plugin Discovery Mechanism

Kestra 0.17.0 uses a new mechanism to discover and load plugins. If you use custom plugins, follow this guide to make the necessary adjustments.

Recursive rendering of Pebble expressions

Since 0.14.0, kestra's templating engine has changed the default rendering behavior to not recursive.

Renamed Plugins

Many core plugins have been renamed in Kestra 0.17.0, and taskDefaults are now pluginDefaults. While these are non-breaking changes, we recommend updating your flows to use the new names.

Schedule Conditions

The scheduleConditions property of Schedule trigger is deprecated. Instead, use conditions to define custom scheduling conditions.

Subflow outputs behavior

The outputs property of a parent flow's Subflow task is deprecated. Instead, use flow outputs to pass data between flows.

Deprecation of Templates

Since 0.11.0, Templates are deprecated and disabled by default. Please use subflows instead.

Volume Mount

How to migrate volume-enabled to the plugin configuration.