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

Error response from daemon: conflict: unable to remove repository reference "nginx:1.26" (must force) - container 3f2a1b4c5d6e is using its referenced image 8198fd003752

Pe scurt

Nu poți șterge imaginea cu docker rmi pentru că un container (pornit sau oprit) a fost creat din ea. Șterge întâi containerul cu docker rm (după docker stop, dacă rulează), apoi imaginea; docker ps -a --filter ancestor=imagine îți arată containerele.

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

Ce înseamnă

Fiecare container ține legătura cu imaginea din care a fost creat, inclusiv după ce s-a oprit. Docker refuză să șteargă o imagine folosită, ca să nu rămână containere fără straturile de bază.

Mesajul îți dă tot ce trebuie: repository reference "nginx:1.26" e imaginea pe care voiai s-o ștergi, container 3f2a1b4c5d6e e containerul care o folosește (ID-ul scurt), iar (must force) spune că ai putea forța cu -f. Forțarea scoate doar eticheta, iar imaginea rămâne pe disc cât timp containerul există, deci nu eliberează spațiu.

Cel mai des apare după ce ai lucrat câteva zile: containerele oprite se adună și nu le vezi în docker ps, ci doar în docker ps -a. Varianta image is being used by running container apare când containerul chiar rulează.

De ce apare: cauzele frecvente

1Un container oprit folosește încă imaginea

Greșit
BASH
docker ps        # nu apare nimic
docker rmi nginx:1.26
Corect
BASH
docker ps -a --filter ancestor=nginx:1.26
docker rm site-vechi
docker rmi nginx:1.26

docker ps arată doar containerele pornite. Cele oprite se văd cu -a și trebuie șterse înainte de imagine.

2Containerul încă rulează

Greșit
BASH
docker rmi nginx:1.26
Corect
BASH
docker stop site-vechi
docker rm site-vechi
docker rmi nginx:1.26

Un container pornit nu poate fi șters fără oprire (sau rm -f), iar imaginea lui nu poate fi ștearsă cât el există.

3Ai folosit rmi -f și te aștepți să eliberezi spațiu

Greșit
BASH
docker rmi -f nginx:1.26
docker system df   # spațiul a rămas ocupat
Corect
BASH
docker rm -f site-vechi
docker rmi nginx:1.26

Cu -f se scoate eticheta, dar straturile rămân cât timp un container le folosește. Ștergerea containerului eliberează cu adevărat imaginea.

Repară tu

Repară eroarea, direct în pagină

Vrei să ștergi imaginea veche nginx:1.26, dar docker rmi nginx:1.26 dă eroarea conflict: unable to remove repository reference. Găsește containerul care o folosește (site-vechi), oprește-l și șterge-l, apoi șterge imaginea nginx:1.26. Nu folosi -f la rmi.

Indiciu

docker ps -a --filter ancestor=nginx:1.26 îți arată containerul vinovat.

Alte forme ale mesajului

  • Error response from daemon: conflict: unable to delete 8198fd003752 (cannot be forced) - image is being used by running container 3f2a1b4c5d6e
  • Error response from daemon: conflict: unable to delete 8198fd003752 (must be forced) - image is referenced in multiple repositories

Cum o eviți pe viitor

  • Pornește containerele de test cu --rm, ca să se șteargă singure la oprire.
  • Fă periodic curățenie cu docker container prune (containerele oprite), apoi docker image prune (imaginile fără tag).
  • Înainte de docker rmi, verifică cine folosește imaginea: docker ps -a --filter ancestor=nume:tag.
  • Pentru proiectele compose, docker compose down --rmi local șterge containerele și imaginile construite de proiect în ordinea corectă.

Întrebări frecvente

Ce înseamnă „image is referenced in multiple repositories”?

Aceeași imagine (același ID) are mai multe etichete, de exemplu app:1.0 și app:latest. Șterge-o după nume, câte o etichetă (docker rmi app:1.0 app:latest), nu după ID.

E periculos docker rmi -f?

Nu strică nimic, dar de obicei nu face ce vrei: containerele rămân, iar imaginea apare ca <none>. Mai curat e să ștergi întâi containerele.

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.