docker-image-pull

Download images from a registry

TLDR

Pull an image
$ docker image pull [image]
Pull specific tag
$ docker image pull [image]:[tag]
Pull all tags
$ docker image pull -a [image]
Pull by digest
$ docker image pull [image]@[sha256:digest]
Pull for a specific platform
$ docker image pull --platform [linux/arm64] [image]:[tag]
Pull from specific registry
$ docker image pull [registry.example.com/image]:[tag]

SYNOPSIS

docker image pull [options] name[:tag|@digest]

DESCRIPTION

docker image pull downloads a Docker image or repository from a registry to the local Docker daemon. When no registry is specified, Docker Hub serves as the default source. If no tag is provided, the latest tag is assumed.The pull operation downloads image layers in parallel for efficiency. If some layers already exist locally from other images, Docker reuses them through its content-addressable storage system, minimizing bandwidth and storage requirements.Images can be pulled by tag for version-specific deployments or by SHA256 digest for immutable, verifiable image references. The --platform flag enables pulling multi-architecture images for cross-platform development and deployment scenarios.

PARAMETERS

-a, --all-tags

Download all tagged images.
--disable-content-trust
Skip image verification.
--platform string
Set platform (e.g., linux/amd64).
-q, --quiet
Suppress verbose output.

INSTALL

sudo apt install docker-cli
sudo dnf install docker-cli
sudo pacman -S docker
sudo apk add docker-cli
sudo zypper install docker
brew install docker
nix profile install nixpkgs#docker

SEE ALSO

docker-pull(1), docker-image(1), docker-image-ls(1)