mirror of https://github.com/docker/buildx.git
63 lines
2.3 KiB
Markdown
63 lines
2.3 KiB
Markdown
# buildx rm
|
|
|
|
```text
|
|
docker buildx rm [OPTIONS] [NAME] [NAME...]
|
|
```
|
|
|
|
<!---MARKER_GEN_START-->
|
|
Remove one or more builder instances
|
|
|
|
### Options
|
|
|
|
| Name | Type | Default | Description |
|
|
|:------------------------------------|:---------|:--------|:-----------------------------------------|
|
|
| [`--all-inactive`](#all-inactive) | | | Remove all inactive builders |
|
|
| [`--builder`](#builder) | `string` | | Override the configured builder instance |
|
|
| [`-f`](#force), [`--force`](#force) | | | Do not prompt for confirmation |
|
|
| [`--keep-daemon`](#keep-daemon) | | | Keep the BuildKit daemon running |
|
|
| [`--keep-state`](#keep-state) | | | Keep BuildKit state |
|
|
|
|
|
|
<!---MARKER_GEN_END-->
|
|
|
|
## Description
|
|
|
|
Removes the specified or current builder. It is a no-op attempting to remove the
|
|
default builder.
|
|
|
|
## Examples
|
|
|
|
### <a name="all-inactive"></a> Remove all inactive builders (--all-inactive)
|
|
|
|
Remove builders that are not in running state.
|
|
|
|
```console
|
|
$ docker buildx rm --all-inactive
|
|
WARNING! This will remove all builders that are not in running state. Are you sure you want to continue? [y/N] y
|
|
```
|
|
|
|
### <a name="builder"></a> Override the configured builder instance (--builder)
|
|
|
|
Same as [`buildx --builder`](buildx.md#builder).
|
|
|
|
### <a name="force"></a> Do not prompt for confirmation (--force)
|
|
|
|
Do not prompt for confirmation before removing inactive builders.
|
|
|
|
```console
|
|
$ docker buildx rm --all-inactive --force
|
|
```
|
|
|
|
### <a name="keep-daemon"></a> Keep the BuildKit daemon running (--keep-daemon)
|
|
|
|
Keep the BuildKit daemon running after the buildx context is removed. This is
|
|
useful when you manage BuildKit daemons and buildx contexts independently.
|
|
Only supported by the
|
|
[`docker-container`](https://docs.docker.com/build/drivers/docker-container/)
|
|
and [`kubernetes`](https://docs.docker.com/build/drivers/kubernetes/) drivers.
|
|
|
|
### <a name="keep-state"></a> Keep BuildKit state (--keep-state)
|
|
|
|
Keep BuildKit state, so it can be reused by a new builder with the same name.
|
|
Currently, only supported by the [`docker-container` driver](https://docs.docker.com/build/drivers/docker-container/).
|