docker compose pull: Pull Service Images

Pull the images for every service that uses one.

docker compose pull downloads images for services defined with image:. This page covers selective pulls, quiet mode, and the registry errors CI hits.

What it does

docker compose pull fetches the images referenced by services (those with image:). Services that are built locally have no remote image; use --ignore-buildable to skip them cleanly.

Common usage

Terminal

docker compose pull
docker compose pull db redis
docker compose pull --quiet
docker compose pull --ignore-buildable

Common errors in CI

"toomanyrequests: You have reached your pull rate limit" hits compose pull just like docker pull when images come from Docker Hub - docker login first or mirror the images. "pull access denied ... repository does not exist or may require docker login" means a private image without auth. Pre-pulling with compose pull before up surfaces registry errors early instead of mid-up.

Related guides

docker pull: Usage, Options & Rate-Limit ErrorsHow docker pull works: fetching images from a registry, digests and platforms, and fixing Docker Hub rate-lim… Docker "toomanyrequests: rate limit exceeded" - Fix Docker Hub Pull LimitsFix Docker Hub "toomanyrequests: You have reached your pull rate limit" in CI by authenticating, caching imag… docker compose up: Start Services & CI ErrorsHow docker compose up works: starting all services from a compose file, detached mode, --build, --wait, and t… docker login: Authenticate to a Registry in CIHow docker login works: authenticating to Docker Hub, GHCR, or ECR with a token from stdin, and the auth erro…