policy rate_limit_error ai_generated true

Error: toomanyrequests: You have reached your pull rate limit

ID: policy/docker-hub-rate-limit

Also available as: JSON · Markdown
85%Fix Rate
88%Confidence
3Evidence
2023-01-01First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
any active — — —

Root Cause

Docker Hub rate limit: 100 pulls/6h anonymous, 200 pulls/6h authenticated.

generic

Workarounds

  1. 90% success Authenticate with Docker Hub for higher limits 
    docker login -u  -p
  2. 88% success Use a pull-through registry cache 
    Run registry:2 with proxy.remoteurl=https://registry-1.docker.io

Dead Ends

Common approaches that don't work:

  1. Add retry loops with no backoff 80% fail

    Rate limits are time-based quotas - retries within the window consume more quota.

  2. Create multiple anonymous accounts to rotate 85% fail

    Violates Docker Hub ToS and IPs may get blocked.