buildx/docs/reference/buildx_debug_build.md

docker buildx debug build

Start a build

Aliases

docker buildx debug build, docker buildx debug b

Options

Name	Type	Default	Description
--add-host	stringSlice		Add a custom host-to-IP mapping (format: host:ip)
--allow	stringSlice		Allow extra privileged entitlement (e.g., network.host, security.insecure)
--attest	stringArray		Attestation parameters (format: type=sbom,generator=image)
--build-arg	stringArray		Set build-time variables
--build-context	stringArray		Additional build contexts (e.g., name=path)
--builder	string		Override the configured builder instance
--cache-from	stringArray		External cache sources (e.g., user/app:cache, type=local,src=path/to/dir)
--cache-to	stringArray		Cache export destinations (e.g., user/app:cache, type=local,dest=path/to/dir)
--cgroup-parent	string		Set the parent cgroup for the RUN instructions during build
--detach			Detach buildx server (supported only on linux)
-f, --file	string		Name of the Dockerfile (default: PATH/Dockerfile)
--iidfile	string		Write the image ID to the file
--label	stringArray		Set metadata for an image
--load			Shorthand for --output=type=docker
--metadata-file	string		Write build result metadata to the file
--network	string	default	Set the networking mode for the RUN instructions during build
--no-cache			Do not use cache when building the image
--no-cache-filter	stringArray		Do not cache specified stages
-o, --output	stringArray		Output destination (format: type=local,dest=path)
--platform	stringArray		Set target platform for build
--print	string		Print result of information request (e.g., outline, targets)
--progress	string	auto	Set type of progress output (auto, plain, tty). Use plain to show container output
--provenance	string		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	string		Specify root directory of server to connect
--sbom	string		Shorthand for --attest=type=sbom
--secret	stringArray		Secret to expose to the build (format: id=mysecret[,src=/local/secret])
--server-config	string		Specify buildx server config file (used only when launching new server)
--shm-size	bytes	0	Size of /dev/shm
--ssh	stringArray		SSH agent socket or keys to expose to the build (format: default|<id>[=<socket>|<key>[,<key>]])
-t, --tag	stringArray		Name and optionally a tag (format: name:tag)
--target	string		Set the target build stage to build
--ulimit	ulimit		Ulimit options