github.com/jaylevin/jenkins-library@v1.230.4/documentation/docs/infrastructure/docker-rate-limit.md (about)

     1  # Troubleshooting "Error response from daemon: toomanyrequests: You have reached your pull rate limit"
     2  
     3  You may face the following error in your pipelines:
     4  
     5  ```
     6  docker pull <some image>
     7  Using default tag: latest
     8  Error response from daemon: toomanyrequests: You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://www.docker.com/increase-rate-limit
     9  ```
    10  
    11  Those occur because Docker Hub has introduced rate limiting in November 2020. More background information is available [here](https://www.docker.com/pricing/resource-consumption-updates).
    12  
    13  There are various options to mitigate this issue, which are listed below in no particular order.
    14  No single option will work in *all* use-cases, please pick what works best for you.
    15  
    16  ## Company-internal Docker Hub mirror
    17  
    18  If your company uses Artifactory for example, you might want to check if [Docker Hub mirroring](https://jfrog.com/knowledge-base/how-to-configure-a-remote-repository-in-artifactory-to-proxy-a-private-docker-registry-in-docker-hub/) is already enabled for you.
    19  
    20  You could configure that registry for example using this snippet in your `.pipeline/config.yml` file.
    21  
    22  ```
    23  steps:
    24    dockerExecute:
    25      dockerRegistryUrl: 'https://my.internal.registry:1234'
    26  ```
    27  
    28  ## Authenticated pulls from Docker Hub
    29  
    30  The [`dockerExecute`](../steps/dockerExecute) step has an option `dockerRegistryCredentialsId` which you can use with any Docker Hub account.
    31  See [Docker's information on pricing](https://www.docker.com/pricing) to check which type of account is right for you.
    32  
    33  ## Alternative Docker registry
    34  
    35  Project "Piper"'s Docker images are also published to [GitHub Container Registry](https://github.com/orgs/SAP/packages?tab=packages&q=ppiper).
    36  We don't have much experience with that, but in case the other options don't work for you, you might want to try consuming the images from there.
    37  
    38  ## Hyperscaler mirror
    39  
    40  If you use some kind of hyperscaler, your provider might offer a Docker Hub mirror for you.
    41  Please check the respective documentation of your provider.