toomanyrequests: You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://www.docker.com/increase-rate-limit
Docker Hub limitează numărul de descărcări pe o perioadă, mai strict pentru utilizatorii nelogați (limita se numără pe adresa IP). Loghează-te cu docker login, refolosește imaginile deja descărcate, fixează taguri ca să nu tragi mereu din nou și, în firmă, folosește un mirror sau registry-ul propriu.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fiecare docker pull (și fiecare FROM dintr-un build care descarcă manifestul) contează la limita de descărcări a Docker Hub. Când o depășești, registry-ul răspunde cu HTTP 429, iar Docker afișează toomanyrequests.
Pentru utilizatorii nelogați, limita se aplică adresei IP. De aceea eroarea apare des în firmă sau în CI, unde zeci de oameni sau joburi ies pe internet prin aceeași adresă: tu ai descărcat puțin, dar colegii au consumat limita. Utilizatorii logați au limita proprie, mai mare, iar abonamentele plătite au limite și mai mari.
Mesajul exact s-a schimbat în timp (variantele mai noi spun unauthenticated pull rate limit), dar reparația e aceeași: autentificare, mai puține descărcări inutile și cache.
De ce apare: cauzele frecvente
1Pull-uri nelogate dintr-o rețea comună
docker pull redis:7cat ~/token.txt | docker login -u andrei --password-stdin
docker pull redis:7Logat, limita e a contului tău, nu a adresei IP împărțite cu toată firma.
2Pipeline care descarcă la fiecare rulare
docker build --pull --no-cache -t api .docker build -t api .--pull și --no-cache forțează descărcarea imaginii de bază de fiecare dată. Fără ele, build-ul refolosește imaginea locală.
3Tagul latest, verificat mereu
FROM node:latestFROM node:20-alpineCu un tag fix, refolosești imaginea locală mai mult timp și știi exact ce versiune rulezi.
Repară eroarea, direct în pagină
Pe un calculator din firmă, docker pull redis:7 dă toomanyrequests: You have reached your pull rate limit. Loghează-te pe Docker Hub ca andrei cu tokenul din ~/token.txt, apoi descarcă redis:7 și pornește din el containerul cache.
Indiciu
cat ~/token.txt | docker login -u andrei --password-stdin, apoi pull și docker run -d --name cache redis:7.
Reparația
cat ~/token.txt | docker login -u andrei --password-stdin
docker pull redis:7
docker run -d --name cache redis:7De ce merge
Nelogat, limita de descărcări e a adresei IP, împărțită cu toți colegii. După docker login, cererile se numără pe contul tău, deci docker pull redis:7 trece. Odată descărcată, imaginea rămâne local: docker run o refolosește fără să mai contacteze Docker Hub.
Alte forme ale mesajului
Error response from daemon: toomanyrequests: You have reached your unauthenticated pull rate limit. https://www.docker.com/increase-rate-limitERROR: failed to solve: node:20-alpine: failed to resolve source metadata for docker.io/library/node:20-alpine: failed to copy: httpReadSeeker: failed open: unexpected status code https://registry-1.docker.io/v2/library/node/manifests/sha256:...: 429 Too Many Requests - Server message: toomanyrequests: You have reached your pull rate limit.
Cum o eviți pe viitor
- Loghează-te pe Docker Hub pe calculatorul tău și în CI (cu un token).
- Fixează tagurile imaginilor de bază și nu folosi
--pull/--no-cachela fiecare build. - În CI, păstrează cache-ul de imagini între joburi.
- În firmă, configurează un mirror de registry sau copiază imaginile des folosite în registry-ul propriu.
Întrebări frecvente
Cât durează până se resetează limita?
Limita se calculează pe o fereastră de timp, deci după o perioadă poți descărca din nou. Valorile exacte se schimbă; cele actuale sunt pe pagina de prețuri Docker Hub.
Afectează și imaginile deja descărcate?
Nu. Containerele din imaginile locale pornesc normal. Problema apare doar când Docker trebuie să ia ceva de pe Docker Hub.
Erori înrudite
docker: Error response from daemon: pull access denied for ngnix, repository does not exist or may require 'docker login': denied: requested access to the resource is denied Docker nu găsește imaginea cerută pe Docker Hub: de obicei numele e scris greșit (ngnix în loc de nginx) sau e o imagine privată ori una locală care nu există încă. Corectează numele sau construiește imaginea înainte, iar pentru cele private rulează docker login. Error response from daemon: Get "https://registry-1.docker.io/v2/": unauthorized: incorrect username or password Docker Hub a refuzat perechea utilizator + parolă la docker login. Folosește numele de utilizator Docker Hub (nu adresa de email) și, dacă ai autentificare în doi pași sau ești în firmă, un Personal Access Token în locul parolei, dat cu --password-stdin. Error response from daemon: manifest for nginx:1.99 not found: manifest unknown: manifest unknown Imaginea există pe registry, dar tagul cerut (aici 1.99) nu. Alege un tag care există, de exemplu nginx:1.27 sau nginx:alpine, după lista de taguri de pe pagina imaginii; la imaginile tale, verifică dacă ai urcat chiar tagul pe care îl ceri. Învață Docker de la zero, cu exerciții la fiecare lecție
Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
