buildx/docs/reference/buildx_inspect.md

buildx inspect

docker buildx inspect [NAME]

Inspect current builder instance

Options

Name	Type	Default	Description
--bootstrap			Ensure builder has booted before inspecting
--builder	string		Override the configured builder instance

Description

Shows information about the current or specified builder.

Examples

Ensure that the builder is running before inspecting (--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)

Same as 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

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

$ 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