docker buildx inspect
Description
Inspect current builder instance
Usage
$ 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.
Options
| Name, shorthand | Default | Description |
--bootstrap |
Ensure builder has booted before inspecting | |
--builder |
Override the configured builder instance |
Examples
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
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 |
Related commands
| 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 |