docker buildx debug build

Description Start a build
Usage docker buildx debug build [OPTIONS] PATH | URL | -
Aliases
docker build docker builder build docker image build docker buildx b

This command is experimental

Experimental features are intended for testing and feedback as their functionality or design may change between releases without warning or can be removed entirely in a future release.

Description

Start a build

Options

Option Default Description
--add-host Add a custom host-to-IP mapping (format: host:ip)
--allow Allow extra privileged entitlement (e.g., network.host, security.insecure)
--annotation Add annotation to the image
--attest Attestation parameters (format: type=sbom,generator=image)
--build-arg Set build-time variables
--build-context Additional build contexts (e.g., name=path)
--cache-from External cache sources (e.g., user/app:cache, type=local,src=path/to/dir)
--cache-to Cache export destinations (e.g., user/app:cache, type=local,dest=path/to/dir)
--call build Set method for evaluating build (check, outline, targets)
--cgroup-parent Set the parent cgroup for the RUN instructions during build
--check Shorthand for --call=check
--detach experimental (CLI) Detach buildx server (supported only on linux)
-f, --file Name of the Dockerfile (default: PATH/Dockerfile)
--iidfile Write the image ID to a file
--label Set metadata for an image
--load Shorthand for --output=type=docker
--metadata-file Write build result metadata to a file
--network Set the networking mode for the RUN instructions during build
--no-cache Do not use cache when building the image
--no-cache-filter Do not cache specified stages
-o, --output Output destination (format: type=local,dest=path)
--platform Set target platform for build
--progress auto Set type of progress output (auto, plain, tty, rawjson). Use plain to show container output
--provenance Shorthand for --attest=type=provenance
--pull Always attempt to pull all referenced images
--push Shorthand for --output=type=registry
-q, --quiet Suppress the build output and print image ID on success
--root experimental (CLI) Specify root directory of server to connect
--sbom Shorthand for --attest=type=sbom
--secret Secret to expose to the build (format: id=mysecret[,src=/local/secret])
--server-config experimental (CLI) Specify buildx server config file (used only when launching new server)
--shm-size Shared memory size for build containers
--ssh SSH agent socket or keys to expose to the build (format: default|<id>[=<socket>|<key>[,<key>]])
-t, --tag Name and optionally a tag (format: name:tag)
--target Set the target build stage to build
--ulimit Ulimit options