toomanyrequests error when building an environment

Version/Environment:

Any version of Domino

Issue:

Building an environment fails. The build contains this error message in the build logs:

429 Too Many Requests - Server message: toomanyrequests: You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://www.docker.com/increase-rate-limit

Root Cause:

The Docker Hub limits the number of requests to it to 100 pulls per 6 hours per IP address. This can occur if multiple people in a Domino deployment make multiple builds from a Docker Hub. You can confirm the docker image you are pulling from is a Docker Hub image by looking for specific URLs in the build logs that begin with:

 https://registry-1.docker.io/xxxxx

Resolution:

If the image you need only resides on Docker Hub, you must wait for the allotted 6 hours before pulling that image and making an environment from it. If you do not require an image on Docker Hub, then you can pull an image from an existing environment:

1. Click Create Environment.
   
2. From the Base Environment / Image, select  Start from an existing Environment
   

Another option is to select Start from a custom base image and put another registry that is not Docker Hub like quay.io:

Notes/Information:

More information regarding the download rate for Docker Hub: https://docs.docker.com/docker-hub/download-rate-limit/