docker buildx debug_build

Start a build

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.


docker buildx debug build [OPTIONS] PATH | URL | -


Start a build


--add-hostAdd a custom host-to-IP mapping (format: host:ip)
--allowAllow extra privileged entitlement (e.g.,, security.insecure)
--annotationAdd annotation to the image
--attestAttestation parameters (format: type=sbom,generator=image)
--build-argSet build-time variables
--build-contextAdditional build contexts (e.g., name=path)
--cache-fromExternal cache sources (e.g., user/app:cache, type=local,src=path/to/dir)
--cache-toCache export destinations (e.g., user/app:cache, type=local,dest=path/to/dir)
--cgroup-parentSet the parent cgroup for the RUN instructions during build
--compressCompress the build context using gzip
--cpu-periodLimit the CPU CFS (Completely Fair Scheduler) period
--cpu-quotaLimit the CPU CFS (Completely Fair Scheduler) quota
--cpu-shares-cCPU shares (relative weight)
--cpuset-cpusCPUs in which to allow execution (0-3, 0,1)
--cpuset-memsMEMs in which to allow execution (0-3, 0,1)
--detachexperimental (CLI) Detach buildx server (supported only on linux)
--file-fName of the Dockerfile (default: PATH/Dockerfile)
--force-rmAlways remove intermediate containers
--iidfileWrite the image ID to the file
--isolationContainer isolation technology
--labelSet metadata for an image
--loadShorthand for --output=type=docker
--memory-mMemory limit
--memory-swapSwap limit equal to memory plus swap: -1 to enable unlimited swap
--metadata-fileWrite build result metadata to the file
--networkSet the networking mode for the RUN instructions during build
--no-cacheDo not use cache when building the image
--no-cache-filterDo not cache specified stages
--output-oOutput destination (format: type=local,dest=path)
--platformSet target platform for build
--printexperimental (CLI) Print result of information request (e.g., outline, targets)
--progressautoSet type of progress output (auto, plain, tty). Use plain to show container output
--provenanceShorthand for --attest=type=provenance
--pullAlways attempt to pull all referenced images
--pushShorthand for --output=type=registry
--quiet-qSuppress the build output and print image ID on success
--rmtrueRemove intermediate containers after a successful build
--rootexperimental (CLI) Specify root directory of server to connect
--sbomShorthand for --attest=type=sbom
--secretSecret to expose to the build (format: id=mysecret[,src=/local/secret])
--security-optSecurity options
--server-configexperimental (CLI) Specify buildx server config file (used only when launching new server)
--shm-sizeSize of /dev/shm
--squashexperimental (CLI) Squash newly built layers into a single new layer
--sshSSH agent socket or keys to expose to the build (format: default|<id>[=<socket>|<key>[,<key>]])
--tag-tName and optionally a tag (format: name:tag)
--targetSet the target build stage to build
--ulimitUlimit options