buildx/docs/reference/buildx_debug_build.md

docker buildx debug build

Start a build

Aliases

docker build, docker builder build, docker image build, docker buildx b

Options

Name	Type	Default	Description
--add-host	stringSlice		Add a custom host-to-IP mapping (format: host:ip)
--allow	stringArray		Allow extra privileged entitlement (e.g., network.host, security.insecure, device)
--annotation	stringArray		Add annotation to the image
--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)
--call	string	build	Set method for evaluating build (check, outline, targets)
--cgroup-parent	string		Set the parent cgroup for the RUN instructions during build
--check	bool		Shorthand for --call=check
-D, --debug	bool		Enable debug logging
-f, --file	string		Name of the Dockerfile (default: PATH/Dockerfile)
--iidfile	string		Write the image ID to a file
--label	stringArray		Set metadata for an image
--load	bool		Shorthand for --output=type=docker
--metadata-file	string		Write build result metadata to a file
--network	string	default	Set the networking mode for the RUN instructions during build
--no-cache	bool		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
--policy	stringArray		Policy configuration (format: filename=path[,filename=path][,reset=true|false][,disabled=true|false][,strict=true|false][,log-level=level])
--progress	string	auto	Set type of progress output (auto, none, plain, quiet, rawjson, tty). Use plain to show container output
--provenance	string		Shorthand for --attest=type=provenance
--pull	bool		Always attempt to pull all referenced images
--push	bool		Shorthand for --output=type=registry,unpack=false
-q, --quiet	bool		Suppress the build output and print image ID on success
--resource	stringArray		Resource limits for build containers (format: memory=2g, cpu-quota=50000)
--sbom	string		Shorthand for --attest=type=sbom
--secret	stringArray		Secret to expose to the build (format: id=mysecret[,src=/local/secret])
--shm-size	bytes	0	Shared memory size for build containers
--ssh	stringArray		SSH agent socket or keys to expose to the build (format: default|<id>[=<socket>|<key>[,<key>]])
-t, --tag	stringArray		Image identifier (format: [registry/]repository[:tag])
--target	string		Set the target build stage to build
--ulimit	ulimit		Ulimit options