- Documentation
Container Registry
Container Registry (CR)
FAQ
Registry replication
How do I fix the "TOOMANYREQUESTS" error during replication from Docker Hub?
Registry replication
How do I fix the "TOOMANYREQUESTS" error during replication from Docker Hub?
How do I fix the "TOOMANYREQUESTS" error during replication from Docker Hub?
Issue description
When replicating an instance from Docker Hub to CR, the following TOOMANYREQUESTS error may appear. Detailed error message:
http status code: 429, body: { "errors": [ { "code": "TOOMANYREQUESTS", "message": "You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://www.docker.com/increase-rate-limit" } ] }
Solution
This error is caused by Docker Hub pull rate limits for free accounts. Solutions:
- Adjust your pull strategy.
- The following methods are recommended:
- Use exact regular expression matching instead of fuzzy matching to avoid pulling unnecessary images.
- Set the interval to more than six hours to prevent rate limiting caused by frequent image pulls.
- Upgrade to a Docker Pro or Docker Team account.
Last updated: 2026.10.19 15:46:50