Scroll to navigation

DOCKER-BUILDX-USE(1) DOCKER-BUILDX-USE(1)

NAME

docker-buildx-use - Set the current builder instance

SYNOPSIS

docker buildx use [OPTIONS] NAME

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.

OPTIONS

--default[=false] Set builder as default for current context

--global[=false] Builder persists context changes

-h, --help[=false] help for use

OPTIONS INHERITED FROM PARENT COMMANDS

--builder="" Override the configured builder instance

EXAMPLE

### Override the configured builder instance (--builder) {#builder}
Same as [`buildx --builder`](/reference/cli/docker/buildx/#builder).

SEE ALSO

docker-buildx(1)

Apr 2025