docker buildx debug build

DescriptionStart a build
Usagedocker buildx debug build [OPTIONS] PATH | URL | -
Aliases
docker build docker builder build docker image build docker buildx b

Experimental

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

OptionDefaultDescription
--add-hostAdd a custom host-to-IP mapping (format: host:ip)
--allowAllow extra privileged entitlement (e.g., network.host, 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)
--callbuildSet method for evaluating build (check, outline, targets)
--cgroup-parentSet the parent cgroup for the RUN instructions during build
--checkShorthand for --call=check
--detachexperimental (CLI) Detach buildx server (supported only on linux)
-f, --fileName of the Dockerfile (default: PATH/Dockerfile)
--iidfileWrite the image ID to a file
--labelSet metadata for an image
--loadShorthand for --output=type=docker
--metadata-fileWrite build result metadata to a 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
-o, --outputOutput destination (format: type=local,dest=path)
--platformSet target platform for build
--progressautoSet type of progress output (auto, plain, tty, rawjson). Use plain to show container output
--provenanceShorthand for --attest=type=provenance
--pullAlways attempt to pull all referenced images
--pushShorthand for --output=type=registry
-q, --quietSuppress the build output and print image ID on success
--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])
--server-configexperimental (CLI) Specify buildx server config file (used only when launching new server)
--shm-sizeShared memory size for build containers
--sshSSH agent socket or keys to expose to the build (format: default|<id>[=<socket>|<key>[,<key>]])
-t, --tagName and optionally a tag (format: name:tag)
--targetSet the target build stage to build
--ulimitUlimit options