docker builder build

Description

Build an image from a Dockerfile

API 1.31+ The client and daemon API must both be at least 1.31 to use this command. Use the docker version command on the client to check your client and daemon API versions.

Usage

docker builder build [OPTIONS] PATH | URL | -

Options

Name, shorthand	Default	Description
--add-host		Add a custom host-to-IP mapping (host:ip)
--build-arg		Set build-time variables
--cache-from		Images to consider as cache sources
--cgroup-parent		Optional parent cgroup for the container
--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)
--disable-content-trust	true	Skip image verification
--file , -f		Name of the Dockerfile (Default is ‘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
--memory , -m		Memory limit
--memory-swap		Swap limit equal to memory plus swap: ‘-1’ to enable unlimited swap
--network		API 1.25+ Set the networking mode for the RUN instructions during build
--no-cache		Do not use cache when building the image
--output , -o		API 1.40+ Output destination (format: type=local,dest=path)
--platform		experimental (daemon)API 1.32+ Set platform if server is multi-platform capable
--progress	auto	Set type of progress output (auto, plain, tty). Use plain to show container output
--pull		Always attempt to pull a newer version of the image
--quiet , -q		Suppress the build output and print image ID on success
--rm	true	Remove intermediate containers after a successful build
--secret		API 1.39+ Secret file to expose to the build (only if BuildKit enabled): id=mysecret,src=/local/secret
--security-opt		Security options
--shm-size		Size of /dev/shm
--squash		experimental (daemon)API 1.25+ Squash newly built layers into a single new layer
--ssh		API 1.39+ SSH agent socket or keys to expose to the build (only if BuildKit enabled) (format: default|[=|[,]])
--stream		experimental (daemon)API 1.31+ Stream attaches to server to negotiate build context
--tag , -t		Name and optionally a tag in the ‘name:tag’ format
--target		Set the target build stage to build.
--ulimit		Ulimit options

Parent command

Command	Description
docker builder	Manage builds

Related commands

Command	Description
docker builder build	Build an image from a Dockerfile
docker builder prune	Remove build cache