Error pulling image configuration: toomanyrequests

Too many requests to Docker Hub


Pipeline fails with the following error:

Continuing execution.
Pulling image codefresh/cfstep-helm:3.0.2 
error pulling image configuration: toomanyrequests: Too Many Requests. Please see 

The image codefresh/cfstep-helm is just an example. This error can happen for other Docker images as well.

Or, with this error message from Docker Hub:

You have reached your pull rate limit. You may increase the limit by authenticating and upgrading:

Possible cause

This issue occurs because your pipeline has triggered the Docker Hub limit announced in August 2020.

Users who pull Docker images have the following limits:

  • Free plan: Anonymous users: 100 pulls per 6 hours
  • Free plan: Authenticated users: 200 pulls per 6 hours
  • Pro plan: Unlimited
  • Team plan: Unlimited

The limits depend on the pricing plan of the user who performs the pull action, and not the user who owns the Docker image.

If you don’t have a Docker Hub integration in Codefresh, all your Docker images are pulled as an anonymous user and because Docker Hub applies the rate limit for each IP address, your whole Codefresh installation can easily hit the limits if you have many teams and users.


Docker Hub integrations in Codefresh

Docker Hub integrations in Codefresh

This way, when Codefresh tries to pull an image, it uses the connected integration instead of sending anonymous requests.

If the integration is for a Docker Hub pro/team plan, you have unlimited pulls. If the integration is for the free plan your rate limit is doubled.

We also advise to you add multiple Docker Hub integrations if it makes sense for your teams, as this action spreads the pull actions to multiple DockerHub accounts.

Troubleshooting common issues