...
Eroare Docker · Docker Compose

WARN[0000] Found orphan containers ([magazin-cache-1]) for this project. If you removed or renamed this service in your compose file, you can run this command with the --remove-orphans flag to clean it up.

Pe scurt

În proiect au rămas containere ale unui serviciu pe care l-ai scos sau redenumit în compose.yaml. Compose nu le mai gestionează, dar ele rulează în continuare. Curăță-le cu docker compose up -d --remove-orphans (sau docker compose down --remove-orphans și apoi up).

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

Ce înseamnă

Compose leagă containerele de proiect prin etichete (numele proiectului și al serviciului). Când rulezi up, compară containerele cu eticheta proiectului cu serviciile din fișier. Un container al unui serviciu care nu mai există în fișier e un orfan: rămâne pornit, ocupă porturi și memorie, dar nicio comandă docker compose nu-l mai oprește.

Apare după ce ai șters sau redenumit un serviciu (cache devine redis), după ce ai pornit proiectul cu alt fișier (-f compose.dev.yaml) sau când două proiecte din foldere cu același nume ajung să aibă același nume de proiect.

Orfanii nu se șterg automat, ca să nu pierzi ceva ce încă folosești. --remove-orphans îi șterge explicit; volumele lor numite rămân.

De ce apare: cauzele frecvente

1Serviciu scos din compose.yaml

Greșit
BASH
# ai șters serviciul cache din fișier
docker compose up -d
Corect
BASH
docker compose up -d --remove-orphans

--remove-orphans șterge containerele proiectului care nu mai au serviciu în fișier.

2Serviciu redenumit

Greșit
BASH
# cache: devine redis:
docker compose up -d
# magazin-cache-1 și magazin-redis-1 rulează amândouă
Corect
BASH
docker compose down --remove-orphans
docker compose up -d

Redenumirea creează un serviciu nou; containerul vechi rămâne orfan până îl ștergi.

3Proiecte diferite cu același nume

Greșit
BASH
cd ~/clienti/magazin && docker compose up -d
cd ~/teste/magazin && docker compose up -d
Corect
BASH
docker compose -p magazin-teste up -d

Numele proiectului vine din folder. Cu -p (sau name: în fișier) proiectele sunt separate.

Repară tu

Repară eroarea, direct în pagină

În ~/magazin, ai scos serviciul cache din compose.yaml, iar docker compose up -d afișează Found orphan containers ([magazin-cache-1]). Curăță proiectul ca să nu mai existe containerul magazin-cache-1, apoi pornește din nou serviciul web.

Indiciu

docker compose down --remove-orphans, apoi docker compose up -d.

Alte forme ale mesajului

  • Found orphan containers ([magazin-cache-1]) for this project. If you removed or renamed this service in your compose file, you can run this command with the --remove-orphans flag to clean it up.
  • level=warning msg="Found orphan containers ([magazin-worker-1 magazin-worker-2]) for this project. If you removed or renamed this service in your compose file, you can run this command with the --remove-orphans flag to clean it up."

Cum o eviți pe viitor

Când scoți sau redenumești un serviciu, rulează imediat docker compose up -d --remove-orphans. Dă proiectului un nume explicit în compose.yaml (name: magazin), ca să nu depinzi de numele folderului. Poți seta COMPOSE_REMOVE_ORPHANS=1 în mediu, ca orfanii să fie șterși mereu.

Întrebări frecvente

--remove-orphans îmi șterge datele?

Șterge containerele orfane, nu volumele numite. Datele dintr-un volum declarat rămân; se pierde doar ce era scris direct în containerul șters.

Cum văd orfanii înainte să-i șterg?

docker ps -a --filter label=com.docker.compose.project=magazin listează toate containerele proiectului. Cele al căror serviciu nu mai e în fișier sunt orfanii.

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.