...
Eroare Docker · Docker Compose

env file /home/ana/magazin/.env not found: stat /home/ana/magazin/.env: no such file or directory

Pe scurt

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

Greșit
BASH
git clone ... magazin && cd magazin
docker compose up -d
Corect
BASH
cp .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

Greșit
BASH
ls -a
# env  compose.yaml
Corect
BASH
mv env .env

Calea din env_file trebuie să corespundă exact numelui fișierului.

3Fișier opțional

Greșit
BASH
env_file: .env.local
Corect
BASH
env_file:
  - path: .env.local
    required: false

Cu required: false (Compose 2.24+), proiectul pornește și fără fișier.

Repară tu

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.

Alte forme ale mesajului

  • env file /home/ana/magazin/.env.local not found: stat /home/ana/magazin/.env.local: no such file or directory
  • Couldn't find env file: /home/ana/magazin/.env
  • docker: 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

← 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.