DOCKER(1)		      Docker User Manuals		     DOCKER(1)



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



SYNOPSIS
       docker builder build [OPTIONS] PATH | URL | -



DESCRIPTION
       Build an image from a Dockerfile



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" instructions
       during build


       --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


       --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


       --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-builder(1)

Docker Community		   Sep 2025			     DOCKER(1)