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
    - option: timeout
      value_type: duration
      default_value: 20s
      description: Override the default timeout for loading builder status
      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
    - option: debug
      shorthand: D
      value_type: bool
      default_value: "false"
      description: Enable debug logging
      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's 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`](/reference/cli/docker/buildx/#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]
    > The asterisk (`*`) next to node build platform(s) indicate they have been
    > manually set during `buildx create`. Otherwise the platforms were
    > automatically detected.

    ```console
    $ docker buildx inspect elated_tesla
    Name:          elated_tesla
    Driver:        docker-container
    Last Activity: 2022-11-30 12:42:47 +0100 CET

    Nodes:
    Name:           elated_tesla0
    Endpoint:       unix:///var/run/docker.sock
    Driver Options: env.BUILDKIT_STEP_LOG_MAX_SPEED="10485760" env.JAEGER_TRACE="localhost:6831" image="moby/buildkit:latest" network="host" env.BUILDKIT_STEP_LOG_MAX_SIZE="10485760"
    Status:         running
    Flags:          --debug --allow-insecure-entitlement security.insecure --allow-insecure-entitlement network.host
    BuildKit:       v0.10.6
    Platforms:      linux/arm64*, linux/arm/v7, linux/arm/v6
    Labels:
     org.mobyproject.buildkit.worker.executor:         oci
     org.mobyproject.buildkit.worker.hostname:         docker-desktop
     org.mobyproject.buildkit.worker.network:          host
     org.mobyproject.buildkit.worker.oci.process-mode: sandbox
     org.mobyproject.buildkit.worker.selinux.enabled:  false
     org.mobyproject.buildkit.worker.snapshotter:      overlayfs
    GC Policy rule#0:
     All:           false
     Filters:       type==source.local,type==exec.cachemount,type==source.git.checkout
     Keep Duration: 48h0m0s
     Keep Bytes:    488.3MiB
    GC Policy rule#1:
     All:           false
     Keep Duration: 1440h0m0s
     Keep Bytes:    24.21GiB
    GC Policy rule#2:
     All:        false
     Keep Bytes: 24.21GiB
    GC Policy rule#3:
     All:        true
     Keep Bytes: 24.21GiB
    ```

    `debug` flag can also be used to get more information about the builder:

    ```console
    $ docker --debug buildx inspect elated_tesla
    ```
deprecated: false
hidden: false
experimental: false
experimentalcli: false
kubernetes: false
swarm: false

