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.
Usage
docker buildx debug build [OPTIONS] PATH | URL | -
Description
Start a build
Options
| Option | Short | 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) | ||
--cgroup-parent | Set the parent cgroup for the RUN instructions during build | ||
--compress | Compress the build context using gzip | ||
--cpu-period | Limit the CPU CFS (Completely Fair Scheduler) period | ||
--cpu-quota | Limit the CPU CFS (Completely Fair Scheduler) quota | ||
--cpu-shares | -c | CPU shares (relative weight) | |
--cpuset-cpus | CPUs in which to allow execution (0-3, 0,1) | ||
--cpuset-mems | MEMs in which to allow execution (0-3, 0,1) | ||
--detach | experimental (CLI) Detach buildx server (supported only on linux) | ||
--file | -f | Name of the Dockerfile (default: PATH/Dockerfile) | |
--force-rm | Always remove intermediate containers | ||
--iidfile | Write the image ID to the file | ||
--isolation | Container isolation technology | ||
--label | Set metadata for an image | ||
--load | Shorthand for --output=type=docker | ||
--memory | -m | Memory limit | |
--memory-swap | Swap limit equal to memory plus swap: -1 to enable unlimited swap | ||
--metadata-file | Write build result metadata to the 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 | ||
--output | -o | Output destination (format: type=local,dest=path) | |
--platform | Set target platform for build | ||
--print | experimental (CLI) Print result of information request (e.g., outline, targets) | ||
--progress | auto | Set type of progress output (auto, plain, tty). 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 | ||
--quiet | -q | Suppress the build output and print image ID on success | |
--rm | true | Remove intermediate containers after a successful build | |
--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]) | ||
--security-opt | Security options | ||
--server-config | experimental (CLI) Specify buildx server config file (used only when launching new server) | ||
--shm-size | Size of /dev/shm | ||
--squash | experimental (CLI) Squash newly built layers into a single new layer | ||
--ssh | SSH agent socket or keys to expose to the build (format: default|<id>[=<socket>|<key>[,<key>]]) | ||
--tag | -t | Name and optionally a tag (format: name:tag) | |
--target | Set the target build stage to build | ||
--ulimit | Ulimit options |