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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când rulezi docker run imagine și imaginea nu e pe calculator, daemon-ul încearcă s-o descarce (Unable to find image 'ngnix:latest' locally). Registry-ul răspunde că nu are depozitul ngnix sau că nu ai voie să-l vezi.
Mesajul e intenționat vag: repository does not exist or may require 'docker login'. Din motive de securitate, Docker Hub nu spune dacă depozitul nu există sau există, dar e privat. În practică, la începători cauza e aproape mereu un nume greșit: o literă inversată, un prefix lipsă (postgres e oficială, dar bitnami/postgresql are prefix) sau numele unei imagini pe care urma s-o construiești tu cu docker build, dar n-ai construit-o încă, ori ai construit-o cu alt tag.
Caută numele corect cu docker search sau pe hub.docker.com și compară-l literă cu literă cu ce ai scris.
De ce apare: cauzele frecvente
1Numele imaginii e scris greșit
docker run -d -p 8080:80 ngnixdocker run -d -p 8080:80 nginxPe Docker Hub nu există depozitul ngnix, deci descărcarea eșuează. Cu numele corect, imaginea oficială nginx se descarcă normal.
2Imaginea ta locală n-a fost construită (sau are alt nume)
docker build -t magazin-api .
docker run -d magazin_apidocker build -t magazin-api .
docker images magazin-api
docker run -d magazin-apiDocker caută întâi local magazin_api, nu-l găsește și încearcă Docker Hub. Numele din run trebuie să fie exact cel din build.
3Imagine privată fără autentificare
docker pull firma/api-intern:2.1docker login
docker pull firma/api-intern:2.1Depozitele private se descarcă doar după docker login cu un cont care are acces la ele.
4Prefixul organizației lipsește sau e greșit
docker pull postgresqldocker pull postgres:16
# sau imaginea altei organizații, cu prefix:
docker pull bitnami/postgresqlImaginile oficiale au nume scurte (postgres, nginx); cele publicate de alte organizații au forma organizatie/nume.
Repară eroarea, direct în pagină
Colegul tău a încercat să pornească un server web cu docker run -d --name web -p 8080:80 ngnix și a primit eroarea pull access denied for ngnix. Repară comanda: pornește containerul web din imaginea oficială nginx, cu portul 8080 al calculatorului legat la portul 80, și verifică pagina cu curl localhost:8080.
Indiciu
Numele imaginii oficiale este nginx (n-g-i-n-x).
Reparația
Numele corect al imaginii este nginx:
docker run -d --name web -p 8080:80 nginx
curl -s localhost:8080Răspunsul conține <title>Welcome to nginx!</title>.
De ce merge
ngnix nu există pe Docker Hub, așa că daemon-ul nu are ce descărca și containerul nici nu se creează. Cu numele corect, nginx, imaginea se descarcă, containerul web pornește și publică portul 80 pe portul 8080 al calculatorului, deci curl localhost:8080 afișează pagina implicită „Welcome to nginx!”. Când primești eroarea, compară întâi numele literă cu literă cu cel de pe Docker Hub.
Alte forme ale mesajului
Error response from daemon: pull access denied for magazin-api, repository does not exist or may require 'docker login': denied: requested access to the resource is deniedERROR: failed to solve: magazin-api:1.0: failed to resolve source metadata for docker.io/library/magazin-api:1.0: pull access denied, repository does not exist or may require authorization: server message: insufficient_scope: authorization failed
Cum o eviți pe viitor
- Copiază numele imaginii de pe pagina ei de pe Docker Hub în loc să-l scrii din memorie.
- Pentru imaginile tale, folosește același nume în
docker build -tși îndocker run(cel mai sigur, dintr-o variabilă sau din compose.yaml). - Verifică ce ai local cu
docker imagesînainte dedocker run. - Pentru registry-uri private, fă
docker login(saudocker login registry.firma.ro) înainte de pull.
Întrebări frecvente
Sunt logat pe Docker Hub și tot primesc eroarea. De ce?
Pentru că, cel mai probabil, depozitul chiar nu există: numele e greșit sau imaginea e într-un alt cont. Autentificarea ajută doar la depozitele private la care contul tău are acces.
Apare la docker build, la linia FROM. E aceeași eroare?
Da: imaginea de bază din FROM nu se găsește. Verifică numele și tagul din FROM; dacă e o imagine construită local, construiește-o înainte (sau folosește o etapă multi-stage cu AS).
Care e diferența față de „manifest unknown”?
La pull access denied nu se găsește depozitul (numele). La manifest unknown depozitul există, dar tagul cerut nu.
Erori înrudite
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. invalid reference format: repository name (MagazinWeb) must be lowercase Numele imaginilor Docker pot conține doar litere mici, cifre și separatorii . _ - /, deci MagazinWeb e refuzat. Scrie numele cu litere mici, de exemplu docker build -t magazin-web:1.0 . denied: requested access to the resource is denied La docker push, registry-ul refuză imaginea pentru că numele ei nu e în contul tău (sau nu ești logat). Etichetează imaginea cu utilizatorul tău, docker tag site:1.0 utilizator/site:1.0, fă docker login și urcă docker push utilizator/site:1.0. Î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.
