buildx/docs/reference/buildx_use.md

buildx use

docker buildx use [OPTIONS] NAME

Set the current builder instance

Options

Name	Type	Default	Description
--builder	string		Override the configured builder instance
-D, --debug	bool		Enable debug logging
--default	bool		Set builder as default for current context
--global	bool		Builder persists context changes
--timeout	duration	20s	Override the default global timeout (as duration, for example 1m20s)

Description

Switches the current builder instance. Build commands invoked after this command will run on a specified builder. Alternatively, a context name can be used to switch to the default builder of that context.

Examples

Override the configured builder instance (--builder)

Same as buildx --builder.