File: buildx_use.md

package info (click to toggle)
docker-buildx 0.19.3%2Bds1-4
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 2,852 kB
  • sloc: sh: 318; makefile: 73
file content (32 lines) | stat: -rw-r--r-- 1,084 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# buildx use

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

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

### Options

| Name                    | Type     | Default | Description                                |
|:------------------------|:---------|:--------|:-------------------------------------------|
| [`--builder`](#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           |


<!---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.

## Examples

### <a name="builder"></a> Override the configured builder instance (--builder)

Same as [`buildx --builder`](buildx.md#builder).