Troubleshoot Docker Hub

If you experience issues with Docker Hub, refer to the following solutions.

You have reached your pull rate limit (429 response code)

Error message

When this issue occurs, you receive following error message in the Docker CLI or in the Docker Engine logs:

You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://www.docker.com/increase-rate-limits

Possible causes

• You have reached your pull rate limit as an authenticated Docker Personal user.
• You have reached your pull rate limit as an unauthenticated user based on your IPv4 address or IPv6 /64 subnet.

Solution

You can use one of the following solutions:

• Authenticate or upgrade your Docker account.
• View your pull rate limit, wait until your pull rate limit decreases, and then try again.

Too many requests (429 response code)

Error message

When this issue occurs, you receive following error message in the Docker CLI or in the Docker Engine logs:

Too Many Requests

Possible causes

• You have reached the Abuse rate limit.

Solution

1. Check for broken CI/CD pipelines accessing Docker Hub and fix them.
2. Implement a retry with back-off solution in your automated scripts to ensure that you're not resending thousands of requests per minute.

500 response code

Error message

When this issue occurs, the following error message is common in the Docker CLI or in the Docker Engine logs:

Unexpected status code 500

Possible causes

• There is a temporary Docker Hub service issue.

Solution

1. View the Docker System Status Page and verify that all services are operational.
2. Try accessing Docker Hub again. It may be a temporary issue.
3. Contact Docker Support to report the issue.