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.

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)

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.