...
Eroare Docker · Docker Compose

volume "pgdata" already exists but was not created by Docker Compose. Use `external: true` to use an existing volume

Pe scurt

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

Greșit
BASH
volumes:
  pgdata:
    name: pgdata
Corect
BASH
volumes:
  pgdata:
    external: true

Compose folosește volumul existent ca resursă externă și nu mai avertizează.

2Volum creat de mână pentru mai multe proiecte

Greșit
BASH
docker volume create date-comune
# compose.yaml: volumes: { date-comune: { name: date-comune } }
Corect
BASH
volumes:
  date-comune:
    external: true

Volumul extern nu aparține niciunui proiect, deci nu e șters de down -v.

3Volum extern cu alt nume în proiect

Greșit
BASH
volumes:
  date:
    external: true
# Docker caută volumul „date”
Corect
BASH
volumes:
  date:
    external: true
    name: pgdata

name leagă cheia din compose.yaml de numele real al volumului.

Repară tu

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.

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 volume
  • external 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

← 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.