Buildx

Global

Build multi-platform image

docker buildx build --platform <platforms> -t <image_name>:<tag> .

Build and push multi-platform image

docker buildx build --platform <platforms> -t <image_name>:<tag> --push .

Buildx Setup

Create a new builder instance

docker buildx create --name <builder_name> --use

List builder instances

docker buildx ls

Switch to a builder instance

docker buildx use <builder_name>

Remove a builder instance

docker buildx rm <builder_name>

Image Management

Push a specific platform image

docker buildx build --platform <platforms> -t <image_name>:<tag> --push .

Inspect multi-platform image manifest

docker buildx imagetools inspect <image_name>:<tag>

Create a new tag for an existing multi-platform image

docker buildx imagetools create --tag <new_image_name>:<new_tag> <existing_image_name>:<existing_tag>

Advanced

Enable experimental features

export DOCKER_CLI_EXPERIMENTAL=enabled

Use BuildKit for faster builds (set globally)

export DOCKER_BUILDKIT=1

Platforms

Example list of supported platforms

linux/amd64,linux/arm64,linux/arm/v7

Build for all platforms with cache

docker buildx build --platform linux/amd64,linux/arm64 --cache-from type=registry,ref=<cache_image> -t <image_name>:<tag> --push .