WARN[0000] The "DB_PAROLA" variable is not set. Defaulting to a blank string.
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
# compose.yaml
environment:
POSTGRES_PASSWORD: ${DB_PAROLA}
# nu există .envecho 'DB_PAROLA=Secret2026' > .env
docker compose up -dCompose citește automat .env din folderul proiectului și înlocuiește ${DB_PAROLA} cu valoarea de acolo.
2Variabila e doar în env_file al serviciului
env_file: secrete.env
environment:
POSTGRES_PASSWORD: ${DB_PAROLA}docker compose --env-file secrete.env up -denv_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
DB_PAROLA=Secret2026
# alt terminal:
docker compose up -dexport DB_PAROLA=Secret2026
docker compose up -dFără export, variabila nu e transmisă comenzilor, iar un terminal nou nu o are deloc.
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.
Reparația
Creează .env lângă compose.yaml și pornește din nou proiectul:
echo 'DB_PAROLA=Secret2026' > .env
docker compose config
docker compose up -d
docker compose psdocker compose config arată acum POSTGRES_PASSWORD: Secret2026, iar magazin-db-1 are starea Up.
De ce merge
Fără valoare, ${DB_PAROLA} devine un șir gol, iar imaginea postgres refuză să pornească fără parolă. Fișierul .env din folderul proiectului e citit automat de Compose la fiecare comandă, deci ${DB_PAROLA} devine Secret2026. docker compose up -d observă că s-a schimbat configurarea serviciului db și recreează containerul cu parola nouă.
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 datelevel=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
Error: Database is uninitialized and superuser password is not specified. 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). dependency failed to start: container magazin-db-1 is unhealthy Un serviciu are depends_on cu condition: service_healthy, iar healthcheck-ul dependenței (aici db) pică, deci Compose nu pornește serviciul care așteaptă. Citește motivul cu docker inspect magazin-db-1 (State.Health.Log) și repară comanda din healthcheck sau serviciul în sine. no configuration file provided: not found Docker Compose nu găsește compose.yaml (sau docker-compose.yml) în folderul curent. Intră în folderul proiectului cu cd înainte de docker compose, sau dă fișierul explicit cu -f cale/compose.yaml. Î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.
