env file /home/ana/magazin/.env not found: stat /home/ana/magazin/.env: no such file or directory
Serviciul are env_file: .env, dar fișierul nu există în folderul proiectului (de obicei pentru că .env nu e pus în Git și există doar .env.example). Creează-l, de exemplu cp .env.example .env și completează valorile, sau marchează fișierul opțional cu required: false.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Cheia env_file din compose.yaml încarcă variabile de mediu dintr-un fișier, pe care Compose îl caută relativ la folderul proiectului. Dacă fișierul lipsește, Compose oprește tot proiectul cu env file ... not found și îți arată calea absolută pe care a căutat-o.
Cel mai des, .env e (corect) în .gitignore, ca să nu ajungă parolele în Git. După o clonare, colegul are doar .env.example, un model fără valori secrete, și trebuie să-și facă propriul .env. Alte cauze: fișierul se numește env sau .env.txt, comanda e rulată cu -f dintr-un alt folder, sau calea din env_file e greșită.
Atenție la diferență: fișierul .env din folderul proiectului e citit automat pentru variabilele ${...} din compose.yaml și nu dă eroare dacă lipsește. Doar env_file: cere ca fișierul să existe.
De ce apare: cauzele frecvente
1.env lipsește după clonare
git clone ... magazin && cd magazin
docker compose up -dcp .env.example .env
nano .env # completează valorile
docker compose up -d.env e ignorat de Git; îl creezi din model, cu valorile tale.
2Fișier cu alt nume
ls -a
# env compose.yamlmv env .envCalea din env_file trebuie să corespundă exact numelui fișierului.
3Fișier opțional
env_file: .env.localenv_file:
- path: .env.local
required: falseCu required: false (Compose 2.24+), proiectul pornește și fără fișier.
Repară eroarea, direct în pagină
Ai clonat proiectul în ~/magazin, iar docker compose up -d dă env file /home/elev/magazin/.env not found. În proiect există .env.example. Creează .env din model, apoi pornește proiectul; containerul serviciului api trebuie să primească variabila MAGAZIN_NUME=Magazin Demo.
Indiciu
cp .env.example .env, apoi docker compose up -d.
Reparația
cp .env.example .env
docker compose up -d
docker compose exec api printenv MAGAZIN_NUMEMagazin DemoDe ce merge
env_file: .env cere ca fișierul să existe în folderul proiectului, altfel Compose oprește tot proiectul. Copiind modelul în .env, Compose îl găsește, citește variabilele și le pune în mediul containerului api la creare, deci MAGAZIN_NUME apare în container. Valorile reale le completezi apoi în .env, care rămâne doar pe calculatorul tău.
Alte forme ale mesajului
env file /home/ana/magazin/.env.local not found: stat /home/ana/magazin/.env.local: no such file or directoryCouldn't find env file: /home/ana/magazin/.envdocker: open .env: no such file or directory.
Cum o eviți pe viitor
Ține în Git un .env.example cu toate cheile și valori de test, iar în README pasul cp .env.example .env. Pune .env în .gitignore, ca parolele reale să nu ajungă în repository. Pentru fișiere cu setări locale opționale, folosește forma lungă a lui env_file cu required: false.
Întrebări frecvente
Care e diferența dintre env_file și fișierul .env al proiectului?
.env din folderul proiectului dă valori pentru ${VAR} din compose.yaml (interpolare). env_file: pune variabilele direct în mediul containerului. Pot fi același fișier, dar au roluri diferite.
Variabilele noi din .env nu apar în container. De ce?
Containerul primește mediul la creare. După ce modifici .env, rulează docker compose up -d, care recreează containerele cu configurarea schimbată.
Erori înrudite
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. 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. 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). Î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.
