volume "pgdata" already exists but was not created by Docker Compose. Use `external: true` to use an existing volume
compose.yaml declară un volum cu numele unui volum creat înainte, din afara Compose (docker volume create sau docker run -v). Dacă vrei să folosești datele existente, marchează-l în compose.yaml cu external: true.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Compose ține evidența resurselor lui prin etichete (com.docker.compose.project, com.docker.compose.volume). Când compose.yaml declară un volum, iar un volum cu exact acel nume există deja fără etichetele Compose, Compose te avertizează: îl va folosi, dar nu el l-a creat, deci nu știe sigur că e al proiectului.
Situația tipică: ai pornit baza întâi cu docker run -v pgdata:/var/lib/postgresql/data, iar acum treci la Compose și vrei aceleași date. Sau ai creat volumul de mână, cu docker volume create, ca să-l păstrezi între proiecte.
external: true îi spune lui Compose că volumul e gestionat în afara proiectului: îl folosește așa cum e, nu încearcă să-l creeze și nu îl șterge la docker compose down -v. Fără external, numele implicit ar fi prefixat cu proiectul (magazin_pgdata), adică alt volum, gol.
De ce apare: cauzele frecvente
1Volum creat înainte cu docker run
volumes:
pgdata:
name: pgdatavolumes:
pgdata:
external: trueCompose folosește volumul existent ca resursă externă și nu mai avertizează.
2Volum creat de mână pentru mai multe proiecte
docker volume create date-comune
# compose.yaml: volumes: { date-comune: { name: date-comune } }volumes:
date-comune:
external: trueVolumul extern nu aparține niciunui proiect, deci nu e șters de down -v.
3Volum extern cu alt nume în proiect
volumes:
date:
external: true
# Docker caută volumul „date”volumes:
date:
external: true
name: pgdataname leagă cheia din compose.yaml de numele real al volumului.
Repară eroarea, direct în pagină
Volumul pgdata a fost creat cu docker volume create înainte de Compose. În ~/magazin, compose.yaml îl declară ca volum al proiectului, iar docker compose up afișează already exists but was not created by Docker Compose. Declară volumul ca extern în compose.yaml și pornește proiectul (serviciul db trebuie să ruleze).
Indiciu
Sub volumes: de sus: pgdata: cu external: true.
Reparația
services:
db:
image: postgres:16
environment:
POSTGRES_PASSWORD: parola
volumes:
- pgdata:/var/lib/postgresql/data
volumes:
pgdata:
external: truedocker compose up -dDe ce merge
Fără external, Compose considera pgdata un volum al proiectului, deși îl crease altcineva. Cu external: true, Compose doar îl caută și îl montează, fără să-l creeze sau să-l șteargă la down -v. Serviciul db pornește cu volumul montat în /var/lib/postgresql/data, iar avertismentul dispare.
Alte forme ale mesajului
WARN[0000] volume "magazin_pgdata" already exists but was not created by Docker Compose. Use `external: true` to use an existing volumeexternal volume "pgdata" not found
Cum o eviți pe viitor
Hotărăște de la început cine gestionează volumul: Compose (îl declari simplu, iar down -v îl poate șterge) sau tu (îl creezi cu docker volume create și îl marchezi external: true). Pentru bazele de date pe care nu vrei să le pierzi, varianta externă te protejează de un down -v dat din greșeală. Verifică cu docker volume inspect pgdata etichetele volumului.
Întrebări frecvente
Datele din volum se pierd dacă ignor avertismentul?
Nu, Compose doar avertizează. Dar e un semn că volumul nu e gestionat cum crezi; cu external: true situația devine explicită.
Ce face docker compose down -v cu un volum extern?
Nimic. Volumele externe nu sunt șterse de Compose; le ștergi tu cu docker volume rm.
Erori înrudite
service "db" refers to undefined volume pgdata: invalid compose project Serviciul montează un volum numit (pgdata:/cale), dar volumul nu e declarat în secțiunea volumes: de la nivelul de sus al fișierului. Adaugă la final volumes: și sub el pgdata:, sau, dacă voiai un folder de pe calculator, scrie calea cu ./ în față (./pgdata:/cale). Error response from daemon: get magazin-date: no such volume Volumul cu acest nume nu există pe daemon: numele e altul (Compose adaugă prefixul proiectului, de exemplu magazin_date), a fost deja șters sau ai scris greșit. Verifică cu docker volume ls și folosește numele exact din listă. Error response from daemon: remove pgdata: volume is in use - [3f2a1b4c5d6e...] Volumul e încă legat de un container, chiar și de unul oprit, așa că Docker nu-l șterge. Găsește containerul cu docker ps -a --filter volume=pgdata, șterge-l (docker rm), apoi rulează docker volume rm pgdata. Pentru proiecte compose: docker compose down -v. Î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.
