docker-buildx-use

docker buildx use [options] name

docker buildx use selects which builder later docker buildx build commands run on. name is a builder from docker buildx ls, or a Docker context name to switch to that context's default builder.Without --global, the selection is tied to the current Docker context: changing context with docker context use can change the active builder. --global keeps the same builder after context switches. --default records the builder as the default for the current context.The BUILDX_BUILDER environment variable and the --builder flag override the selected builder for a single command without changing the stored default.

--default

Set this builder as the default for the current Docker context.

Persist the selection so it survives Docker context changes.

Override the configured builder for this invocation (same as docker buildx --builder).

docker buildx use only changes the default for docker buildx build. Plain docker build still uses the default builder unless you pass --builder or run docker buildx install so docker build is aliased to Buildx. The selected builder must already exist; this command does not create one.

docker-buildx-ls(1), docker-buildx-create(1), docker-buildx-inspect(1), docker(1)

Source code · Documentation