Docker Buildx

Buildx is the Docker CLI plugin that drives BuildKit: builders, multi-platform builds, cache export, attestations and bake (builds described in a file). docker build already uses it on current Docker; use this sheet for the parts beyond a single docker buildx build.

Documentation: Buildx reference · Bake Project: docker/buildx

Verification: options checked against docker buildx --help output for Buildx v0.38.2 (run in the docker:cli image), and the Bake file below was parsed with docker buildx bake --print. No image was built or pushed. Flags can change between releases; run docker buildx <COMMAND> --help for yours.

Related sheets: Docker, Dockerfile, OCI Images, Docker Registry, CI Docker Builds, Buildah.

Build #

Cache #

The default docker driver cannot export cache or build multi-platform images; create a docker-container builder for those.

Attestations #

Builders #

Bake #

docker-bake.hcl (or JSON, or a Compose file) describes targets so one command builds them all.

variable "TAG" {
  default = "latest"
}

group "default" {
  targets = ["app", "worker"]
}

target "app" {
  context    = "."
  dockerfile = "Dockerfile"
  tags       = ["registry.example.com/app:${TAG}"]
  platforms  = ["linux/amd64", "linux/arm64"]
}

target "worker" {
  inherits = ["app"]
  target   = "worker"
  tags     = ["registry.example.com/worker:${TAG}"]
}

Inspect Images in a Registry #

Build History #

Troubleshooting #

See Also #

• Docker
• Dockerfile
• OCI Images
• CI Docker Builds
• Buildah