Fix docker-pull-rate-limit: You have reached your pull rate limit

Tue, 21 Apr 2026 15:08:04 +0800

1. Symptoms

When attempting to pull Docker images from Docker Hub, you encounter an authentication or rate limit error that prevents the image from being downloaded.

Typical Error Messages

You may see one of the following error messages in your terminal or CI/CD logs:

Error response from daemon: toomanyrequests: You have reached your pull rate limit.
Rate limit is 100 pulls per 6 hours per IP address.
Learn more: https://docker.com/products/docker-hub

Error response from daemon: unauthorized: authentication required

You have reached your pull rate limit as of (some date/time).
We recommend an authenticated approach using a Docker ID (free tier).
Learn more at https://docs.docker.com/docker-hub/download-rate-limit/

Error response from daemon: pull access denied for <image-name>,
repository does not exist or may require 'docker login':
denied: requested access to the resource is denied

Observed Behavior

The error typically manifests in these scenarios:

Docker Hub on ErrorVault — Developer Error Code Dictionary

Fix docker-pull-rate-limit: You have reached your pull rate limit

1. Symptoms

Typical Error Messages

Observed Behavior