kestra-io/kestra · error · RuntimeException

Cannot create local repository for plugins

Error message

Cannot create local repository for plugins

What it means

Error "Cannot create local repository for plugins" thrown in kestra-io/kestra.

Solutions

1. Check that the plugins directory path exists and the Kestra process has write permission on it, then retry.
2. Point the plugins path to a writable directory via the --plugins option or the KESTRA_PLUGINS_PATH environment variable.

When it happens

Trigger: Thrown at core/src/main/java/io/kestra/core/plugins/PluginManager.java:129 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/b337c3a636ada4e3. Report an issue: GitHub.

Appendix: source

Thrown at core/src/main/java/io/kestra/core/plugins/PluginManager.java:129

     * @return the repository path or the default one.
     */
    static Path getLocalManagedRepositoryPathOrDefault(final @Nullable String path) {
        Path resolved = Optional.ofNullable(path)
            .map(Path::of)
            .orElseGet(
                () -> Path
                    .of(System.getProperty("java.io.tmpdir"))
                    .resolve("kestra/plugins-repository")
            );
        return createLocalRepositoryIfNotExist(resolved);
    }

    static Path createLocalRepositoryIfNotExist(final Path resolved) {
        if (!Files.exists(resolved)) {
            try {
                Files.createDirectories(resolved);
            } catch (IOException e) {
                throw new RuntimeException("Cannot create local repository for plugins", e);
            }
        }
        return resolved;
    }

}

View on GitHub (pinned to 823fada927)