...
Eroare Docker · Containere care se opresc imediat

Error: Database is uninitialized and superuser password is not specified.

Pe scurt

Imaginea oficială postgres refuză să pornească fără parolă pentru utilizatorul postgres și se oprește cu Exited (1). Pornește containerul cu -e POSTGRES_PASSWORD=parola (în compose: environment: POSTGRES_PASSWORD).

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

Ce înseamnă

La prima pornire, imaginea postgres inițializează baza de date în /var/lib/postgresql/data și creează superutilizatorul postgres. Ca să nu lase din greșeală o bază fără parolă, scriptul de intrare cere variabila POSTGRES_PASSWORD; dacă lipsește, afișează mesajul acesta și iese cu codul 1.

De aceea containerul pare că „nu pornește”: docker ps nu-l arată, docker ps -a îl arată Exited (1), iar docker logs conține textul complet, cu exemplul -e POSTGRES_PASSWORD=password și alternativa POSTGRES_HOST_AUTH_METHOD=trust (nerecomandată).

Atenție la un detaliu: parola se aplică doar la inițializare. Dacă volumul de date există deja dintr-o rulare anterioară, schimbarea lui POSTGRES_PASSWORD nu mai modifică parola existentă. Imaginea mysql are un mesaj asemănător (You need to specify one of the following as an environment variable: MYSQL_ROOT_PASSWORD...).

De ce apare: cauzele frecvente

1Parola lipsește la docker run

Greșit
BASH
docker run -d --name db postgres:16
Corect
BASH
docker run -d --name db -e POSTGRES_PASSWORD=secret postgres:16

Cu POSTGRES_PASSWORD setată, scriptul de intrare inițializează baza și pornește serverul.

2Variabila lipsește în compose.yaml

Greșit
BASH
services:
  db:
    image: postgres:16
Corect
BASH
services:
  db:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: ${DB_PAROLA}

În Compose variabilele containerului se dau la environment; valoarea poate veni din fișierul .env.

3Variabila e scrisă greșit

Greșit
BASH
docker run -d -e POSTGRES_PASS=secret postgres:16
Corect
BASH
docker run -d -e POSTGRES_PASSWORD=secret postgres:16

Imaginea citește exact numele POSTGRES_PASSWORD; orice altă variabilă e ignorată.

Repară tu

Repară eroarea, direct în pagină

Ai pornit baza de date cu docker run -d --name db postgres:16, dar containerul apare Exited (1). Citește motivul în jurnal, apoi recreează containerul db din postgres:16 cu parola secret pentru utilizatorul postgres, astfel încât să ruleze.

Indiciu

Parola se dă ca variabilă de mediu: -e POSTGRES_PASSWORD=secret; containerul vechi trebuie șters întâi.

Alte forme ale mesajului

  • Error: Database is uninitialized and superuser password is not specified. You must specify POSTGRES_PASSWORD to a non-empty value for the superuser. For example, "-e POSTGRES_PASSWORD=password" on "docker run".
  • error: database is uninitialized and password option is not specified You need to specify one of the following as an environment variable: - MYSQL_ROOT_PASSWORD - MYSQL_ALLOW_EMPTY_PASSWORD - MYSQL_RANDOM_ROOT_PASSWORD

Cum o eviți pe viitor

Pune configurarea bazei în compose.yaml, cu parola citită din .env (care nu ajunge în Git), ca să nu depinzi de o comandă lungă ținută minte. Montează un volum pentru date (-v pgdata:/var/lib/postgresql/data), ca baza inițializată să supraviețuiască recreării containerului. Când un container de bază de date nu pornește, primul pas e docker logs: imaginile oficiale explică foarte clar ce lipsește.

Întrebări frecvente

Am pus parola, dar tot nu mă pot conecta cu ea. De ce?

Probabil volumul de date a fost inițializat înainte cu altă parolă: POSTGRES_PASSWORD contează doar la prima pornire, pe un folder de date gol. Schimbă parola cu ALTER USER postgres PASSWORD '…' sau, la o bază de test, șterge volumul și pornește din nou.

Pot folosi POSTGRES_HOST_AUTH_METHOD=trust?

Doar pentru teste locale, izolate. Cu trust, oricine ajunge la port se conectează fără parolă.

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.