buildx/docs/reference/buildx_use.md

# buildx use

```
docker buildx use [OPTIONS] NAME
```

<!---MARKER_GEN_START-->
Set the current builder instance

### Options

| Name | Description |
| --- | --- |
| `--builder string` | Override the configured builder instance |
| `--default` | Set builder as default for current context |
| `--global` | Builder persists context changes |


<!---MARKER_GEN_END-->

## 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.
docs: standardize format for usage Use the usage output of `--help` for each subcommand, to make sure all flags/options are included on the page, and to make it easier to keep docs in sync. Note that the usage output is only used when reading these docs on GitHub; docs.docker.com only consumes the "description" and "example" sections (when present), and generates flag information and usage output from source Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 4 years ago			`# buildx use`

			```
docs: reference docs updates Signed-off-by: Tonis Tiigi <tonistiigi@gmail.com> Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 4 years ago			`docker buildx use [OPTIONS] NAME`
			```
docs: standardize format for usage Use the usage output of `--help` for each subcommand, to make sure all flags/options are included on the page, and to make it easier to keep docs in sync. Note that the usage output is only used when reading these docs on GitHub; docs.docker.com only consumes the "description" and "example" sections (when present), and generates flag information and usage output from source Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 4 years ago
docs: reference docs updates Signed-off-by: Tonis Tiigi <tonistiigi@gmail.com> Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 4 years ago			`<!---MARKER_GEN_START-->`
docs: standardize format for usage Use the usage output of `--help` for each subcommand, to make sure all flags/options are included on the page, and to make it easier to keep docs in sync. Note that the usage output is only used when reading these docs on GitHub; docs.docker.com only consumes the "description" and "example" sections (when present), and generates flag information and usage output from source Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 4 years ago			`Set the current builder instance`

docs: reference docs updates Signed-off-by: Tonis Tiigi <tonistiigi@gmail.com> Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 4 years ago			`### Options`

			`\| Name \| Description \|`
			`\| --- \| --- \|`
			\| `--builder string` \| Override the configured builder instance \|
			\| `--default` \| Set builder as default for current context \|
			\| `--global` \| Builder persists context changes \|


			`<!---MARKER_GEN_END-->`
docs: split reference docs to separate files Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 4 years ago
			`## 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.`