...
Eroare Docker · Imagini, tag-uri și registry

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

Pe scurt

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

Greșit
BASH
docker run -d -p 8080:80 ngnix
Corect
BASH
docker run -d -p 8080:80 nginx

Pe 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)

Greșit
BASH
docker build -t magazin-api .
docker run -d magazin_api
Corect
BASH
docker build -t magazin-api .
docker images magazin-api
docker run -d magazin-api

Docker 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

Greșit
BASH
docker pull firma/api-intern:2.1
Corect
BASH
docker login
docker pull firma/api-intern:2.1

Depozitele private se descarcă doar după docker login cu un cont care are acces la ele.

4Prefixul organizației lipsește sau e greșit

Greșit
BASH
docker pull postgresql
Corect
BASH
docker pull postgres:16
# sau imaginea altei organizații, cu prefix:
docker pull bitnami/postgresql

Imaginile oficiale au nume scurte (postgres, nginx); cele publicate de alte organizații au forma organizatie/nume.

Repară tu

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).

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 denied
  • ERROR: 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 în docker run (cel mai sigur, dintr-o variabilă sau din compose.yaml).
  • Verifică ce ai local cu docker images înainte de docker run.
  • Pentru registry-uri private, fă docker login (sau docker 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

← Toate erorile Docker

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.