...
Eroare Docker · Docker Compose

WARN[0000] The "DB_PAROLA" variable is not set. Defaulting to a blank string.

Pe scurt

compose.yaml folosește ${DB_PAROLA}, dar variabila nu există nici în shell, nici în fișierul .env de lângă compose.yaml, așa că Compose pune un șir gol. Adaugă DB_PAROLA=valoare în .env (în folderul proiectului) sau exportă variabila înainte de docker compose up.

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

Ce înseamnă

Compose înlocuiește ${NUME} din compose.yaml cu valori luate, în ordine, din: variabilele shell-ului din care rulezi comanda, apoi fișierul .env din folderul proiectului. Dacă nu găsește nicio valoare, afișează acest avertisment și folosește un șir gol.

E doar un avertisment (WARN), deci proiectul pornește, dar de obicei cu o configurare stricată: o parolă goală (postgres refuză să pornească), un tag gol de imagine (invalid reference format), un port gol. Trebuie tratat ca o eroare.

Confuzia frecventă: env_file: .env.local la un serviciu nu ajută la ${...} din compose.yaml. env_file trimite variabile în container, iar înlocuirea ${...} se face doar din shell și din .env-ul proiectului (sau un fișier dat cu --env-file). Altă capcană: .env salvat în alt folder sau cu alt nume (env, .env.txt).

De ce apare: cauzele frecvente

1Lipsește fișierul .env

Greșit
BASH
# compose.yaml
    environment:
      POSTGRES_PASSWORD: ${DB_PAROLA}
# nu există .env
Corect
BASH
echo 'DB_PAROLA=Secret2026' > .env
docker compose up -d

Compose citește automat .env din folderul proiectului și înlocuiește ${DB_PAROLA} cu valoarea de acolo.

2Variabila e doar în env_file al serviciului

Greșit
BASH
    env_file: secrete.env
    environment:
      POSTGRES_PASSWORD: ${DB_PAROLA}
Corect
BASH
docker compose --env-file secrete.env up -d

env_file ajunge doar în container. Pentru ${...} din compose.yaml, fișierul se dă cu --env-file sau se numește .env.

3Variabila setată fără export, în alt terminal

Greșit
BASH
DB_PAROLA=Secret2026
# alt terminal:
docker compose up -d
Corect
BASH
export DB_PAROLA=Secret2026
docker compose up -d

Fără export, variabila nu e transmisă comenzilor, iar un terminal nou nu o are deloc.

Repară tu

Repară eroarea, direct în pagină

În ~/magazin, compose.yaml setează parola bazei cu POSTGRES_PASSWORD: ${DB_PAROLA}, dar la docker compose up -d apare The "DB_PAROLA" variable is not set, iar magazin-db-1 se oprește. Dă variabilei valoarea Secret2026 printr-un fișier .env în folderul proiectului și repornește proiectul, astfel încât baza să ruleze.

Indiciu

Compose citește automat fișierul .env de lângă compose.yaml; după ce îl creezi, rulează din nou docker compose up -d.

Alte forme ale mesajului

  • WARN[0000] The "TAG" variable is not set. Defaulting to a blank string.
  • required variable DB_PAROLA is missing a value: lipsește parola bazei de date
  • level=warning msg="The \"DB_PAROLA\" variable is not set. Defaulting to a blank string."

Cum o eviți pe viitor

Pentru valorile obligatorii, folosește forma care oprește pornirea cu un mesaj clar: ${DB_PAROLA:?lipsește parola bazei de date}. Pentru cele opționale, dă o valoare implicită: ${PORT:-8080}. Păstrează un fișier .env.example în Git, cu toate numele de variabile și valori fictive, iar .env real în .gitignore. Verifică înlocuirile cu docker compose config înainte de pornire.

Întrebări frecvente

Am modificat .env, dar containerul are încă valoarea veche. De ce?

Variabilele se aplică la crearea containerului. Rulează din nou docker compose up -d: Compose observă configurarea schimbată și recreează containerul. docker compose restart nu ajunge, pentru că repornește containerul existent, cu vechea configurare.

Ce câștig cu ${VAR:?mesaj}?

În loc de avertisment și un container pornit greșit, Compose se oprește înainte de orice, cu mesajul tău. Erorile de configurare devin evidente imediat.

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.