docker buildx debug build
| Description | Start a build |
|---|---|
| Usage | docker 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
| Option | 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) |
|
--call
|
build
|
Set method for evaluating build (check, outline, targets)
|
--cgroup-parent
|
Set the parent cgroup for the RUN instructions during build
|
|
--check
|
Shorthand for --call=check
|
|
--detach
|
experimental (CLI) Detach buildx server (supported only on linux) | |
-f, --file
|
Name of the Dockerfile (default: PATH/Dockerfile)
|
|
--iidfile
|
Write the image ID to a file | |
--label
|
Set metadata for an image | |
--load
|
Shorthand for --output=type=docker
|
|
--metadata-file
|
Write build result metadata to a 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 | |
-o, --output
|
Output destination (format: type=local,dest=path)
|
|
--platform
|
Set target platform for build | |
--progress
|
auto
|
Set type of progress output (auto, plain, tty, rawjson). 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
|
|
-q, --quiet
|
Suppress the build output and print image ID on success | |
--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]) |
|
--server-config
|
experimental (CLI)
Specify buildx server config file (used only when launching new server) |
|
--shm-size
|
Shared memory size for build containers | |
--ssh
|
SSH agent socket or keys to expose to the build (format: default|<id>[=<socket>|<key>[,<key>]]) |
|
-t, --tag
|
Name and optionally a tag (format: name:tag)
|
|
--target
|
Set the target build stage to build | |
--ulimit
|
Ulimit options |