kestra-io/kestra · error · IllegalArgumentException

A plugin can only access configuration properties from the '

Error message

A plugin can only access configuration properties from the 'kestra.tasks' root property

What it means

Error "A plugin can only access configuration properties from the 'kestra.tasks' root property" thrown in kestra-io/kestra.

Source

Thrown at core/src/main/java/io/kestra/core/runners/DefaultRunContext.java:704

    }

    /**
     * Get access to Kestra internal services.
     * WARNING: this should only be used for very specific needs, plugins should try to avoid using an Kestra internal service.
     */
    public Services services() {
        return new Services(this.applicationContext);
    }

    /**
     * Get a task configuration property from the underlying application context.
     * A task property is a property under the 'kestra.tasks' configuration root.
     *
     * @throws IllegalArgumentException if a property is not inside the 'kestra.tasks' configuration root.
     */
    public <T> Optional<T> getTaskProperty(String name, Class<T> clazz) {
        if (!name.startsWith("kestra.tasks.")) {
            throw new IllegalArgumentException("A plugin can only access configuration properties from the 'kestra.tasks' root property");
        }
        return this.applicationContext.getProperty(name, clazz);
    }

    /**
     * Builder class for constructing new {@link DefaultRunContext} objects.
     */
    @NoArgsConstructor
    @AllArgsConstructor
    @With
    public static class Builder {
        private ApplicationContext applicationContext;
        private VariableRenderer variableRenderer;
        private StorageInterface storageInterface;
        private MetricRegistry meterRegistry;
        private Map<String, Object> variables;
        private List<WorkerTaskResult> dynamicWorkerResults;
        private Map<String, Object> pluginConfiguration;

View on GitHub (pinned to 823fada927)

Solutions

1. Restrict the plugin's configuration lookup to properties under the 'kestra.tasks' root, e.g. 'kestra.tasks.<plugin>.<property>'.
2. Move any needed custom configuration under 'kestra.tasks' in the Kestra configuration file.

When it happens

Trigger: Thrown at core/src/main/java/io/kestra/core/runners/DefaultRunContext.java:704 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of kestra-io/kestra@823fada927 (2026-08-14). Data as JSON: /api/errors/8552f6b14d8be447. Report an issue: GitHub.