---
name: "docker-buildx-use"
section: "1"
platform: "linux"
package: "docker-buildx"
version: "0.13.1+ds1-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/docker-buildx-use"
---

# docker-buildx-use(1)

Set the current builder instance

## 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)](/docker-buildx/1.md)**