docker buildx inspect

Estimated reading time: 2 minutes


Inspect current builder instance

Usage

$ docker buildx inspect [NAME]

Refer to the options section for an overview of available OPTIONS for this command.

Description

Shows information about the current or specified builder.

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

Options

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

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:

$ docker buildx inspect elated_tesla

Name:   elated_tesla
Driver: docker-container

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

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

Parent command

Command Description
docker buildx Docker Buildx
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