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

     1  # buildx use
     2  
     3  ```
     4  docker buildx use [OPTIONS] NAME
     5  ```
     6  
     7  <!---MARKER_GEN_START-->
     8  Set the current builder instance
     9  
    10  ### Options
    11  
    12  | Name                    | Type     | Default | Description                                |
    13  |:------------------------|:---------|:--------|:-------------------------------------------|
    14  | [`--builder`](#builder) | `string` |         | Override the configured builder instance   |
    15  | `--default`             |          |         | Set builder as default for current context |
    16  | `--global`              |          |         | Builder persists context changes           |
    17  
    18  
    19  <!---MARKER_GEN_END-->
    20  
    21  ## Description
    22  
    23  Switches the current builder instance. Build commands invoked after this command
    24  will run on a specified builder. Alternatively, a context name can be used to
    25  switch to the default builder of that context.
    26  
    27  ## Examples
    28  
    29  ### <a name="builder"></a> Override the configured builder instance (--builder)
    30  
    31  Same as [`buildx --builder`](buildx.md#builder).