Download an image from a registry - and beat the Docker Hub rate limit in CI.
docker pull downloads an image (or a specific tag/digest) from a registry to the local daemon. This page covers the flags and the registry errors CI hits most.
What it does
docker pull fetches image layers from a registry. Without a registry prefix it defaults to Docker Hub (docker.io). Without a tag it pulls :latest.
The classic CI failure is "toomanyrequests: You have reached your pull rate limit" from Docker Hub, which rate-limits anonymous and free pulls per IP. Authenticate with docker login before pulling, mirror the image to GHCR or ECR, or use a pull-through cache. A second error: "no matching manifest for linux/amd64 in the manifest list entries" - the image lacks your platform; pass --platform or pick a multi-arch tag.
Frequently asked questions
docker pull: Usage, Options & Rate-Limit Errors?
docker pull downloads an image (or a specific tag/digest) from a registry to the local daemon. This page covers the flags and the registry errors CI hits most.
What it does?
docker pull fetches image layers from a registry. Without a registry prefix it defaults to Docker Hub (docker.io). Without a tag it pulls :latest.
Common errors in CI?
The classic CI failure is "toomanyrequests: You have reached your pull rate limit" from Docker Hub, which rate-limits anonymous and free pulls per IP. Authenticate with docker login before pulling, mirror the image to GHCR or ECR, or use a pull-through cache.
