buildx/docs/reference/buildx_rm.md

# buildx rm

```
docker buildx rm [NAME]
```

<!---MARKER_GEN_START-->
Remove a builder instance

### Options

| Name | Description |
| --- | --- |
| `--builder string` | Override the configured builder instance |
| [`--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="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).
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 rm`

			```
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 rm [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			`Remove a builder instance`

Keep BuildKit state in a volume Signed-off-by: CrazyMax <crazy-max@users.noreply.github.com> 4 years ago			`### Options`

			`\| Name \| Description \|`
			`\| --- \| --- \|`
			\| `--builder string` \| Override the configured builder instance \|
			\| [`--keep-state`](#keep-state) \| Keep BuildKit state \|

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

			`Removes the specified or current builder. It is a no-op attempting to remove the`
			`default builder.`
Keep BuildKit state in a volume Signed-off-by: CrazyMax <crazy-max@users.noreply.github.com> 4 years ago
			`## Examples`

			`### <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).