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

Error response from daemon: reference does not exist

Pe scurt

docker save (sau docker image save) nu găsește imaginea pe care ai numit-o: numele sau tag-ul e scris greșit ori imaginea nu există local. Verifică cu docker images exact cum se numește și dă numele complet, de exemplu docker save -o magazin.tar magazin:1.0.

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

Ce înseamnă

Mesajul vine de la daemon, când îi ceri să exporte într-o arhivă o imagine pe care nu o are. reference înseamnă aici referința imaginii, adică nume:tag (sau ID-ul). Daemon-ul caută exact referința primită și nu o găsește, deci nu are ce salva.

Apare aproape mereu la docker save și docker image save: o literă greșită în nume (magazn în loc de magazin), tag-ul uitat (fără tag, Docker caută :latest, iar tu ai doar :1.0), un nume de registry diferit (andrei/magazin față de magazin) sau o imagine ștearsă între timp cu docker rmi ori docker image prune.

Compară referința din comandă cu coloanele REPOSITORY și TAG din docker images. Pe versiunile noi, cu containerd image store, același caz poate apărea ca No such image.

De ce apare: cauzele frecvente

1Nume scris greșit

Greșit
BASH
docker save -o magazin.tar magazn:1.0
Corect
BASH
docker images magazin
docker save -o magazin.tar magazin:1.0

Daemon-ul caută exact referința dată; magazn nu există, magazin da.

2Tag lipsă

Greșit
BASH
# există doar magazin:1.0
docker save -o magazin.tar magazin
Corect
BASH
docker save -o magazin.tar magazin:1.0

Fără tag, Docker completează :latest, care nu există local.

3Imaginea a fost ștearsă sau are alt prefix

Greșit
BASH
docker save -o api.tar api:2.0
Corect
BASH
docker images | grep api
docker save -o api.tar andrei/api:2.0

După docker tag sau push, imaginea poate exista doar cu numele complet utilizator/nume.

Repară tu

Repară eroarea, direct în pagină

Vrei să muți imaginea magazin:1.0 pe alt calculator, dar docker save -o ~/magazin.tar magazn:1.0 se oprește cu reference does not exist. Verifică ce imagini ai local și salvează imaginea corectă în arhiva ~/magazin.tar.

Indiciu

docker images îți arată numele exact; numele imaginii are un i în plus față de comanda greșită.

Alte forme ale mesajului

  • Error response from daemon: No such image: magazn:1.0
  • Error response from daemon: reference does not exist

Cum o eviți pe viitor

Înainte de docker save, rulează docker images și copiază referința exact din coloanele REPOSITORY:TAG. Pune mereu tag-ul explicit, nu te baza pe latest. În scripturi, păstrează numele imaginii într-o variabilă (IMG=magazin:1.0) folosită și la build, și la save, ca să nu existe două scrieri diferite.

Întrebări frecvente

Pot salva mai multe imagini în aceeași arhivă?

Da: docker save -o tot.tar magazin:1.0 nginx:1.27-alpine. Dacă oricare dintre referințe nu există, comanda se oprește cu această eroare și nu scrie arhiva.

Pot salva după ID în loc de nume?

Da, docker save -o img.tar 3f2a1b4c5d6e merge, dar la docker load imaginea vine fără nume și tag. Cu referința nume:tag, arhiva păstrează și numele.

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.