DOCKER(1) Docker User Manuals DOCKER(1)
NAME
docker-image-build - Build an image from a Dockerfile
SYNOPSIS
docker image build [OPTIONS] PATH | URL | -
DESCRIPTION
Alias for docker build.
OPTIONS
--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="" Set the parent cgroup for the "RUN" instruc-
tions during build
--compress[=false] Compress the build context using gzip
--cpu-period=0 Limit the CPU CFS (Completely Fair Scheduler) pe-
riod
--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)
-f, --file="" Name of the Dockerfile (Default is "PATH/Docker-
file")
--force-rm[=false] Always remove intermediate containers
--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 instruc-
tions during build
--no-cache[=false] Do not use cache when building the image
--platform="" Set platform if server is multi-platform capable
--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
--security-opt=[] Security options
--shm-size=0 Size of "/dev/shm"
--squash[=false] Squash newly built layers into a single new layer
-t, --tag= Name and optionally a tag in the "name:tag" format
--target="" Set the target build stage to build.
--ulimit=[] Ulimit options
SEE ALSO
docker-image(1)
Docker Community Apr 2026 DOCKER(1)
Generated by dwww version 1.14 on Sat Jun 13 07:05:10 CEST 2026.