Skip to content

cli-plugins: support extra directories via environment - #7513

Open
TheLastManStandin wants to merge 1 commit into
docker:masterfrom
TheLastManStandin:5993-plugin-dirs-env
Open

TheLastManStandin wants to merge 1 commit into
docker:masterfrom
TheLastManStandin:5993-plugin-dirs-env

Conversation

@TheLastManStandin

Copy link
Copy Markdown

Summary

Add DOCKER_CLI_PLUGINS_EXTRA_DIRS to configure additional CLI plugin
search paths without editing config.json.

Directories from the environment take precedence over directories from
cliPluginsExtraDirs and the default search paths. Paths are separated
by : on Linux and macOS, or ; on Windows. Empty entries are ignored.
An unset or empty variable preserves the existing behavior.

Add table-driven tests and document the environment variable and search order.

Validation:

  • All unit tests pass.
  • docker buildx bake lint reports 0 issues.
  • Generated Markdown matches the checked-in documentation.
  • Local e2e: 126 tests, 4 skipped.
  • SSH e2e with Docker 29.9.3: 126 tests, 5 skipped.

Release notes (optional)

Add the DOCKER_CLI_PLUGINS_EXTRA_DIRS environment variable to configure additional CLI plugin search paths.

Signed-off-by: Rodion <rodion@gots.ru>
@TheLastManStandin
TheLastManStandin requested review from a team and thaJeztah as code owners November 11, 2026 15:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Allow adding paths to cliPluginsExtraDirs via env var

1 participant