github.com/pdmccormick/importable-docker-buildx@v0.0.0-20240426161518-e47091289030/docs/reference/buildx_rm.md (about)

     1  # buildx rm
     2  
     3  ```text
     4  docker buildx rm [OPTIONS] [NAME] [NAME...]
     5  ```
     6  
     7  <!---MARKER_GEN_START-->
     8  Remove one or more builder instances
     9  
    10  ### Options
    11  
    12  | Name                                | Type     | Default | Description                              |
    13  |:------------------------------------|:---------|:--------|:-----------------------------------------|
    14  | [`--all-inactive`](#all-inactive)   |          |         | Remove all inactive builders             |
    15  | [`--builder`](#builder)             | `string` |         | Override the configured builder instance |
    16  | [`-f`](#force), [`--force`](#force) |          |         | Do not prompt for confirmation           |
    17  | [`--keep-daemon`](#keep-daemon)     |          |         | Keep the BuildKit daemon running         |
    18  | [`--keep-state`](#keep-state)       |          |         | Keep BuildKit state                      |
    19  
    20  
    21  <!---MARKER_GEN_END-->
    22  
    23  ## Description
    24  
    25  Removes the specified or current builder. It is a no-op attempting to remove the
    26  default builder.
    27  
    28  ## Examples
    29  
    30  ### <a name="all-inactive"></a> Remove all inactive builders (--all-inactive)
    31  
    32  Remove builders that are not in running state.
    33  
    34  ```console
    35  $ docker buildx rm --all-inactive
    36  WARNING! This will remove all builders that are not in running state. Are you sure you want to continue? [y/N] y
    37  ```
    38  
    39  ### <a name="builder"></a> Override the configured builder instance (--builder)
    40  
    41  Same as [`buildx --builder`](buildx.md#builder).
    42  
    43  ### <a name="force"></a> Do not prompt for confirmation (--force)
    44  
    45  Do not prompt for confirmation before removing inactive builders.
    46  
    47  ```console
    48  $ docker buildx rm --all-inactive --force
    49  ```
    50  
    51  ### <a name="keep-daemon"></a> Keep the BuildKit daemon running (--keep-daemon)
    52  
    53  Keep the BuildKit daemon running after the buildx context is removed. This is
    54  useful when you manage BuildKit daemons and buildx contexts independently.
    55  Only supported by the
    56  [`docker-container`](https://docs.docker.com/build/drivers/docker-container/)
    57  and [`kubernetes`](https://docs.docker.com/build/drivers/kubernetes/) drivers.
    58  
    59  ### <a name="keep-state"></a> Keep BuildKit state (--keep-state)
    60  
    61  Keep BuildKit state, so it can be reused by a new builder with the same name.
    62  Currently, only supported by the [`docker-container` driver](https://docs.docker.com/build/drivers/docker-container/).