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

Error response from daemon: manifest for nginx:1.99 not found: manifest unknown: manifest unknown

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

O imagine se identifică prin nume:tag. Partea manifest for nginx:1.99 not found spune că registry-ul a găsit depozitul nginx, dar nu are un manifest (descrierea imaginii) pentru tagul 1.99.

Cauzele tipice: un tag inventat sau scris greșit (node:20-alpne), o versiune care încă nu există sau a fost ștearsă, un tag latest care lipsește (multe depozite private nu publică latest, iar docker pull firma/app fără tag cere implicit latest) ori un tag pe care l-ai creat doar local și nu l-ai urcat cu docker push.

Uneori varianta no matching manifest for linux/arm64/v8 in the manifest list entries înseamnă altceva: tagul există, dar nu pentru arhitectura procesorului tău. Atunci soluția e altă imagine sau --platform linux/amd64.

De ce apare: cauzele frecvente

1Tag inexistent sau scris greșit

Greșit
BASH
docker pull nginx:1.99
docker pull node:20-alpne
Corect
BASH
docker pull nginx:1.27
docker pull node:20-alpine

Docker nu ghicește tagul cel mai apropiat. Tagul trebuie să existe exact așa în registry.

2Depozitul nu publică tagul latest

Greșit
BASH
docker pull firma/api
Corect
BASH
docker pull firma/api:2.3.0

Fără tag, Docker cere latest. Dacă echipa publică doar versiuni numerotate, latest nu există și primești manifest unknown.

3Tagul există doar local, nu a fost urcat

Greșit
BASH
docker tag api ana/api:1.1
docker pull ana/api:1.1   # pe alt calculator
Corect
BASH
docker push ana/api:1.1
# apoi, pe alt calculator:
docker pull ana/api:1.1

docker tag creează doar o etichetă locală. Registry-ul o primește abia la docker push.

Repară tu

Repară eroarea, direct în pagină

Încercarea de a descărca nginx:1.99 a dat eroarea manifest unknown. Descarcă o versiune care există, nginx:1.27-alpine, și pornește din ea containerul site, cu portul 8080 al calculatorului legat la portul 80.

Indiciu

Tagul vine după două puncte: nginx:1.27-alpine.

Alte forme ale mesajului

  • docker: Error response from daemon: manifest for node:20-alpne not found: manifest unknown: manifest unknown
  • Error response from daemon: manifest for firma/api:latest not found: manifest unknown: manifest unknown
  • no matching manifest for linux/arm64/v8 in the manifest list entries

Cum o eviți pe viitor

Fixează tagurile în Dockerfile și în compose.yaml după lista oficială de taguri (pagina imaginii pe Docker Hub, secțiunea Tags) și preferă versiuni concrete, ca postgres:16 sau node:20-alpine, în locul lui latest. La imaginile echipei, publică tagurile din pipeline-ul CI imediat după build, ca oricine să poată descărca exact versiunea din documentație. După docker push, verifică tagul cu un docker pull de pe alt calculator sau din CI.

Întrebări frecvente

Cum văd ce taguri are o imagine?

Pe pagina imaginii de pe Docker Hub, la tabul Tags. Local, docker images nume îți arată doar tagurile pe care le-ai descărcat deja.

De ce funcționează la colegul meu?

Probabil are imaginea deja descărcată local (de exemplu un tag construit de el), deci Docker nu mai întreabă registry-ul. La tine, tagul trebuie să existe în registry.

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.