Scroll to navigation

DOCKER(1) Docker User Manuals DOCKER(1)


docker-image-build - Build an image from a Dockerfile


docker image build [OPTIONS] PATH | URL | -


Alias for docker build.


--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[=false] Compress the build context using gzip

--cpu-period=0 Limit the CPU CFS (Completely Fair Scheduler) period

--cpu-quota=0 Limit the CPU CFS (Completely Fair Scheduler) quota

-c, --cpu-shares=0 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

-f, --file="" Name of the Dockerfile (Default is 'PATH/Dockerfile')

--force-rm[=false] Always remove intermediate containers

-h, --help[=false] help for build

--iidfile="" Write the image ID to the file

--isolation="" Container isolation technology

--label= Set metadata for an image

-m, --memory=0 Memory limit

--memory-swap=0 Swap limit equal to memory plus swap: '-1' to enable unlimited swap

--network="default" Set the networking mode for the RUN instructions during build

--no-cache[=false] Do not use cache when building the image

-o, --output=[] Output destination (format: type=local,dest=path)

--platform="" 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[=false] Always attempt to pull a newer version of the image

-q, --quiet[=false] Suppress the build output and print image ID on success

--rm[=true] Remove intermediate containers after a successful build

--secret=[] Secret file to expose to the build (only if BuildKit enabled): id=mysecret,src=/local/secret

--security-opt=[] Security options

--shm-size=0 Size of /dev/shm

--squash[=false] Squash newly built layers into a single new layer

--ssh=[] SSH agent socket or keys to expose to the build (only if BuildKit enabled) (format: default|[=|[,]])

-t, --tag= Name and optionally a tag in the 'name:tag' format

--target="" Set the target build stage to build.

--ulimit=[] Ulimit options



May 2022 Docker Community