Managing Buildx Builders

--- title: Manage builders keywords: build, buildx, builders, buildkit, drivers, backend description: null --- You can create, inspect, and manage builders using `docker buildx` commands, or [using Docker Desktop](#manage-builders-with-docker-desktop). ## Create a new builder The default builder uses the [`docker` driver](drivers/docker.md). You can't manually create new `docker` builders, but you can create builders that use other drivers, such as the [`docker-container` driver](drivers/docker-container.md), which runs the BuildKit daemon in a container. Use the [`docker buildx create`](/reference/cli/docker/buildx/create.md) command to create a builder. ```console $ docker buildx create --name=<builder-name> ``` Buildx uses the `docker-container` driver by default if you omit the `--driver` flag. For more information about available drivers, see [Build drivers](drivers/_index.md). ## List available builders Use `docker buildx ls` to see builder instances available on your system, and the drivers they're using. ```console $ docker buildx ls NAME/NODE DRIVER/ENDPOINT STATUS BUILDKIT PLATFORMS default * docker default default running v0.11.6 linux/amd64, linux/amd64/v2, linux/amd64/v3, linux/386 my_builder docker-container my_builder0 default running v0.11.6 linux/amd64, linux/amd64/v2, linux/amd64/v3, linux/386 ``` The asterisk (`*`) next to the builder name indicates the [selected builder](_index.md#selected-builder). ## Inspect a builder To inspect a builder with the CLI, use `docker buildx inspect <name>`. You can only inspect a builder if the builder is active. You can add the `--bootstrap` flag to the command to start the builder. ```console $ docker buildx inspect --bootstrap my_builder [+] Building 1.7s (1/1) FINISHED => [internal] booting buildkit 1.7s => => pulling image moby/buildkit:buildx-stable-1 1.3s => => creating container buildx_buildkit_my_builder0 0.4s Name: my_builder Driver: docker-container Last Activity: 2023-06-21 18:28:37 +0000 UTC Nodes: Name: my_builder0 Endpoint: unix:///var/run/docker.sock Status: running Buildkit: v0.11.6 Platforms: linux/arm64, linux/amd64, linux/amd64/v2, linux/riscv64, linux/ppc64le, linux/s390x, linux/386, linux/mips64le, linux/mips64, linux/arm/v7, linux/arm/v6 ``` If you want to see how much disk space a builder is using, use the

This section explains how to manage Buildx builders using the `docker buildx` command-line tool. It covers creating new builders (with the `docker-container` driver as default), listing available builders, and inspecting a builder's configuration and status. The `docker buildx ls` command shows available builders and their drivers, while `docker buildx inspect` provides detailed information about a specific builder, including its nodes, endpoint, status, and supported platforms.