.nh
.TH "DOCKER" "1" "Apr 2025" "Docker Community" "Docker User Manuals"

.SH NAME
docker-image-build - Build an image from a Dockerfile


.SH SYNOPSIS
\fBdocker image build [OPTIONS] PATH | URL | -\fP


.SH DESCRIPTION
Alias for \fBdocker build\fR\&.


.SH OPTIONS
\fB--add-host\fP=
	Add a custom host-to-IP mapping ("host:ip")

.PP
\fB--build-arg\fP=
	Set build-time variables

.PP
\fB--cache-from\fP=[]
	Images to consider as cache sources

.PP
\fB--cgroup-parent\fP=""
	Set the parent cgroup for the "RUN" instructions during build

.PP
\fB--compress\fP[=false]
	Compress the build context using gzip

.PP
\fB--cpu-period\fP=0
	Limit the CPU CFS (Completely Fair Scheduler) period

.PP
\fB--cpu-quota\fP=0
	Limit the CPU CFS (Completely Fair Scheduler) quota

.PP
\fB-c\fP, \fB--cpu-shares\fP=0
	CPU shares (relative weight)

.PP
\fB--cpuset-cpus\fP=""
	CPUs in which to allow execution (0-3, 0,1)

.PP
\fB--cpuset-mems\fP=""
	MEMs in which to allow execution (0-3, 0,1)

.PP
\fB--disable-content-trust\fP[=true]
	Skip image verification

.PP
\fB-f\fP, \fB--file\fP=""
	Name of the Dockerfile (Default is "PATH/Dockerfile")

.PP
\fB--force-rm\fP[=false]
	Always remove intermediate containers

.PP
\fB--iidfile\fP=""
	Write the image ID to the file

.PP
\fB--isolation\fP=""
	Container isolation technology

.PP
\fB--label\fP=
	Set metadata for an image

.PP
\fB-m\fP, \fB--memory\fP=0
	Memory limit

.PP
\fB--memory-swap\fP=0
	Swap limit equal to memory plus swap: -1 to enable unlimited swap

.PP
\fB--network\fP="default"
	Set the networking mode for the RUN instructions during build

.PP
\fB--no-cache\fP[=false]
	Do not use cache when building the image

.PP
\fB--platform\fP=""
	Set platform if server is multi-platform capable

.PP
\fB--pull\fP[=false]
	Always attempt to pull a newer version of the image

.PP
\fB-q\fP, \fB--quiet\fP[=false]
	Suppress the build output and print image ID on success

.PP
\fB--rm\fP[=true]
	Remove intermediate containers after a successful build

.PP
\fB--security-opt\fP=[]
	Security options

.PP
\fB--shm-size\fP=0
	Size of "/dev/shm"

.PP
\fB--squash\fP[=false]
	Squash newly built layers into a single new layer

.PP
\fB-t\fP, \fB--tag\fP=
	Name and optionally a tag in the "name:tag" format

.PP
\fB--target\fP=""
	Set the target build stage to build.

.PP
\fB--ulimit\fP=[]
	Ulimit options


.SH SEE ALSO
\fBdocker-image(1)\fP