docker buildx inspect


Inspect current builder instance


$ docker buildx inspect [NAME]

Extended description

Shows information about the current or specified builder.

For example uses of this command, refer to the examples section below.


Name, shorthand Default Description
--bootstrap Ensure builder has booted before inspecting
--builder Override the configured builder instance


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:

$ docker buildx inspect elated_tesla

Name:   elated_tesla
Driver: docker-container

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

Name:      elated_tesla1
Endpoint:  ssh://ubuntu@
Status:    running
Platforms: linux/arm64, linux/arm/v7, linux/arm/v6

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).

Parent command

Command Description
docker buildx Build with BuildKit
Command Description
docker buildx bake Build from a file
docker buildx build Start a build
docker buildx create Create a new builder instance
docker buildx du Disk usage
docker buildx imagetools Commands to work on images in registry
docker buildx inspect Inspect current builder instance
docker buildx ls List builder instances
docker buildx prune Remove build cache
docker buildx rm Remove a builder instance
docker buildx stop Stop builder instance
docker buildx use Set the current builder instance
docker buildx version Show buildx version information