command: docker buildx inspect
short: Inspect current builder instance
long: Shows information about the current or specified builder.
usage: docker buildx inspect [NAME]
pname: docker buildx
plink: docker_buildx.yaml
options:
    - option: bootstrap
      value_type: bool
      default_value: "false"
      description: Ensure builder has booted before inspecting
      details_url: '#bootstrap'
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
inherited_options:
    - option: builder
      value_type: string
      description: Override the configured builder instance
      details_url: '#builder'
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
examples: |-
    ### Ensure that the builder is running before inspecting (--bootstrap) {#bootstrap}

    Use the `--bootstrap` option to ensure that the builder is running before
    inspecting it. If the driver is `docker-container`, then `--bootstrap` starts
    the buildkit container and waits until it is operational. Bootstrapping is
    automatically done during build, and therefore not necessary. The same BuildKit
    container is used during the lifetime of the associated builder node (as
    displayed in `buildx ls`).

    ### Override the configured builder instance (--builder) {#builder}

    Same as [`buildx --builder`](buildx.md#builder).

    ### Get information about a builder instance

    By default, `inspect` shows information about the current builder. Specify the
    name of the builder to inspect to get information about that builder.
    The following example shows information about a builder instance named
    `elated_tesla`:

    > **Note**
    >
    > Asterisk `*` next to node build platform(s) indicate they had been set manually during `buildx create`. Otherwise, it had been autodetected.

    ```console
    $ docker buildx inspect elated_tesla

    Name:   elated_tesla
    Driver: docker-container

    Nodes:
    Name:      elated_tesla0
    Endpoint:  unix:///var/run/docker.sock
    Status:    running
    Buildkit:  v0.10.3
    Platforms: linux/amd64

    Name:      elated_tesla1
    Endpoint:  ssh://ubuntu@1.2.3.4
    Status:    running
    Buildkit:  v0.10.3
    Platforms: linux/arm64*, linux/arm/v7, linux/arm/v6
    ```
deprecated: false
experimental: false
experimentalcli: false
kubernetes: false
swarm: false