registry
docker pull
Downloads an image or repository from a registry into the local image store. Defaults to Docker Hub and the latest tag when unspecified.
docker pull [OPTIONS] NAME[:TAG|@DIGEST]Common flags
| Flag | Purpose |
|---|---|
| -a, --all-tags | Download all tagged images in the repository |
| --platform | Pull a specific platform variant (e.g., linux/arm64) |
| -q, --quiet | Suppress verbose progress output |
| --disable-content-trust | Skip image signature verification (default true) |
Examples
docker pull nginx:1.27-alpinePull a specific tag rather than latest
docker pull --platform linux/amd64 postgres:16Force amd64 image on an arm64 host
docker pull ghcr.io/owner/repo:sha-abc123Pull from GitHub Container Registry
docker pull redis@sha256:e34a2a...Pull by immutable content digest
Gotcha
Pulling :latest is non-deterministic — pin tags or digests in production. Rate limits apply on Docker Hub for anonymous and free-tier pulls.
Related commands
docker push
Uploads a local image or repository to a container registry. The image must be tagged with the registry hostname and repository path before pushing.
docker images
Lists images stored in the local image store with their repository, tag, ID, and size. Alias for docker image ls.
docker tag
Creates a new tag (alias) that refers to an existing image. Tagging is required before pushing to a registry whose hostname is not Docker Hub.
docker run
Creates and starts a new container from a specified image in a single step. This is the primary command for launching workloads and supports extensive configuration for networking, storage, and process control.
← All Docker commands · Docker vs Kubernetes · Docker vs VMs