...
Eroare Docker · Baze de date în containere

initdb: error: directory "/var/lib/postgresql/data" exists but is not empty

Pe scurt

Folderul de date al lui Postgres (montat de pe calculator sau dintr-un disc) conține deja fișiere care nu sunt o bază de date, de exemplu lost+found sau fișiere lăsate acolo. Montează un folder gol sau setează PGDATA la un subfolder: PGDATA=/var/lib/postgresql/data/pgdata.

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

Ce înseamnă

La prima pornire, imaginea postgres rulează initdb, care creează o bază nouă în folderul de date (PGDATA, implicit /var/lib/postgresql/data). Dacă găsește acolo o bază existentă, sare peste inițializare. Dacă găsește alte fișiere, refuză să le amestece cu baza nouă: exists but is not empty, iar containerul se oprește cu Exited (1).

Apare des când:

  • montezi un disc nou sau o partiție direct în folderul de date; discurile ext4 au folderul lost+found în rădăcină (mesajul spune explicit It contains a lost+found directory);
  • faci bind mount la un folder de pe calculator în care ai pus deja fișiere (notițe, un backup .sql, un .gitkeep);
  • ai copiat în folder doar o parte dintr-o bază sau date de la altă versiune.

Soluția recomandată chiar de mesaj: un subfolder al punctului de montare, prin variabila PGDATA.

De ce apare: cauzele frecvente

1Folder montat cu alte fișiere

Greșit
BASH
docker run -d --name db -e POSTGRES_PASSWORD=parola -v ~/pgdata:/var/lib/postgresql/data postgres:16
# ~/pgdata conține notite.txt
Corect
BASH
docker run -d --name db -e POSTGRES_PASSWORD=parola -e PGDATA=/var/lib/postgresql/data/pgdata -v ~/pgdata:/var/lib/postgresql/data postgres:16

initdb lucrează în subfolderul gol pgdata, iar fișierele tale rămân lângă el.

2Disc cu lost+found

Greșit
BASH
volumes:
  - /mnt/disc-nou:/var/lib/postgresql/data
Corect
BASH
environment:
  PGDATA: /var/lib/postgresql/data/pgdata
volumes:
  - /mnt/disc-nou:/var/lib/postgresql/data

lost+found rămâne în rădăcina discului, iar baza stă într-un subfolder separat.

3Folder dedicat bazei

Greșit
BASH
-v ~/proiect:/var/lib/postgresql/data
Corect
BASH
mkdir -p ~/proiect/date-db
-v ~/proiect/date-db:/var/lib/postgresql/data

Un folder nou, folosit doar de Postgres, e gol la prima pornire.

Repară tu

Repară eroarea, direct în pagină

Vrei datele Postgres în ~/pgdata, unde ai deja notite.txt. Cu -v ~/pgdata:/var/lib/postgresql/data, imaginea ar da initdb: error: directory ... exists but is not empty. Pornește containerul db din postgres:16 cu parola parola și același bind mount, dar cu baza într-un subfolder pgdata al punctului de montare. notite.txt trebuie să rămână.

Indiciu

Adaugă -e PGDATA=/var/lib/postgresql/data/pgdata.

Alte forme ale mesajului

  • initdb: error: directory "/var/lib/postgresql/data" exists but is not empty initdb: detail: It contains a lost+found directory, perhaps due to it being a mount point.
  • initdb: hint: If you want to create a new database system, either remove or empty the directory "/var/lib/postgresql/data" or run initdb with an argument other than "/var/lib/postgresql/data".

Cum o eviți pe viitor

Pentru datele bazei, preferă un volum numit (-v pgdata:/var/lib/postgresql/data), pe care îl gestionează Docker și care e gol la început. Dacă ai nevoie de bind mount sau de un disc separat, folosește un folder dedicat doar bazei și setează PGDATA la un subfolder. Nu pune niciodată alte fișiere în folderul de date.

Întrebări frecvente

Pot pur și simplu să șterg fișierele din folder?

Da, dacă știi că nu sunt importante. Pentru lost+found pe un disc montat, varianta curată e subfolderul prin PGDATA, pentru că folderul acela e recreat de sistem.

La MySQL e la fel?

Da: mysqld refuză inițializarea cu --initialize specified but the data directory has files in it. Aborting. Reparația e aceeași: folder gol sau volum numit.

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.