mirror of
https://gitea.com/Lydanne/buildx.git
synced 2025-11-04 10:03:42 +08:00
60 lines
1.9 KiB
Markdown
60 lines
1.9 KiB
Markdown
# buildx rm
|
|
|
|
```
|
|
docker buildx rm [NAME]
|
|
```
|
|
|
|
<!---MARKER_GEN_START-->
|
|
Remove a builder instance
|
|
|
|
### 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 buildkitd 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 buildkitd daemon running (--keep-daemon)
|
|
|
|
Keep the buildkitd daemon running after the buildx context is removed. This is useful when you manage buildkitd daemons and buildx contexts independently.
|
|
Currently, only supported by the [`docker-container` and `kubernetes` drivers](buildx_create.md#driver).
|
|
|
|
### <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](buildx_create.md#driver).
|