docker image build

Estimated reading time: 3 minutes


Build an image from a Dockerfile


docker image build [OPTIONS] PATH | URL | -


Name, shorthand Default Description
--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
--cpu-shares, -c 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
--file, -f   Name of the Dockerfile (Default is ‘PATH/Dockerfile’)
--force-rm false Always remove intermediate containers
--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 default Set the networking mode for the RUN instructions during build
--no-cache false Do not use cache when building the image
--pull false Always attempt to pull a newer version of the image
--quiet, -q 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   Size of /dev/shm, default value is 64MB
--squash false Squash newly built layers into a single new layer
--tag, -t   Name and optionally a tag in the ‘name:tag’ format
--ulimit   Ulimit options

Parent command

Command Description
docker image Manage images
Command Description
docker image build Build an image from a Dockerfile
docker image history Show the history of an image
docker image import Import the contents from a tarball to create a filesystem image
docker image inspect Display detailed information on one or more images
docker image load Load an image from a tar archive or STDIN
docker image ls List images
docker image prune Remove unused images
docker image pull Pull an image or a repository from a registry
docker image push Push an image or a repository to a registry
docker image rm Remove one or more images
docker image save Save one or more images to a tar archive (streamed to STDOUT by default)
docker image tag Create a tag TARGET_IMAGE that refers to SOURCE_IMAGE
chat icon Feedback? Suggestions? Can't find something in the docs?
Edit this page Request docs changes Get support