Docker Hub limits how many images you can pull. If you pull many images in a short time without signing in, some pulls fail. This page shows how to sign in and how to avoid the errors.
Symptoms
Section titled “Symptoms”You install an app, or you pull several images at once with Tools > Stack Manager > Update Stack or the dcpull alias. Some images fail and others work. The failures move to different apps each time you try again.
These messages come from Docker. You can see a timeout:
✘ portainer Error Get "https://registry-1.docker.io/v2/": net/http: TLS handshake timeoutYou can see Docker’s rate limit message:
toomanyrequests: You have reached your pull rate limitDuring an app install, Deployrr stops with this message:
Docker Compose failed to pull image for APPHere APP is the name of the app you were installing. For apps that install extra containers, the message is “Failed to pull image for required dependency” followed by the name.
During Update Stack or Update App (see Update your apps), Deployrr keeps going when a pull fails and still reports success at the end. Read the lines Docker prints during the pull step for Error.
Docker Hub limits pulls. Pulls that are not signed in get a lower limit than pulls from a signed-in account. Pulling a whole stack can use up the limit quickly. Docker changes the numbers from time to time. See Docker’s usage and limits page for the current ones.
Sign in to Docker Hub
Section titled “Sign in to Docker Hub”-
Create a free account at hub.docker.com if you do not have one.
-
Optional but safer (Docker’s advice): in Docker Hub, open your account settings and create an access token. You can paste the token at the password prompt instead of your password.
-
In Deployrr, complete the Prerequisites menu if you haven’t. Docker Login works with any license.
-
Open the Docker menu and choose Docker Login. Before you sign in, the line reads “Login to Docker Account (higher rate limits)”. Deployrr shows an info box about rate limits. Press OK. It then asks for your Docker Hub Username, and Docker asks for your password.
To do it by hand instead, run this in your terminal:
Terminal window sudo docker loginAlways use
sudo. Deployrr runs Docker withsudo, so the login must be saved for the root user. A login withoutsudodoes not help. -
When it works, Deployrr shows “Successfully logged into Docker Hub” and “Docker Hub login complete”. If it fails, you see “Docker login failed”. Check your username and password or token, and try again.
Docker may also print a warning that your credentials are stored unencrypted in
/root/.docker/config.json. Docker saves your login in root’s home folder, and that file is not encrypted. This is why an access token is a better choice than your password.
If Deployrr says you are already logged in and you want another account, run sudo docker logout first, then choose Docker Login again.
Wait for the limit to reset
Section titled “Wait for the limit to reset”If you still see toomanyrequests after you sign in, you have used up your limit. Wait and try again later. Docker’s page lists how long the limit lasts.
Pull fewer images at once
Section titled “Pull fewer images at once”- Update one app at a time. Use Tools > Stack Manager > Update App instead of Update Stack. Pick the app at the “Select an app to update:” prompt. Stack Manager actions need all Prerequisites done and a Basic, Plus or Pro license.
- If Update Stack asks for a Stack Update Mode, that is because you have locally built apps. Standard pulls from Docker Hub only.
- Use the
dcpullalias when you do update everything. It pulls one image at a time and only pulls. Rundcupafterwards to start the new versions. The alias exists only after you install Deployrr’s Bash aliases. See Bash aliases. - Run the update again after a failure. Docker reuses image layers it already has.
Check it worked
Section titled “Check it worked”- In the Docker menu, the Docker Login line shows Logged In.
- Run
dcpullor Update Stack again. In Docker’s pull output, every app showsPulledand none showsError.

