...
Eroare Docker · Dockerfile și docker build

ERROR: failed to solve: failed to read dockerfile: open Dockerfile: no such file or directory

Pe scurt

docker build caută fișierul numit exact Dockerfile în folderul de context (punctul de la final), iar acolo nu există: ești în alt folder, fișierul are alt nume (dockerfile.txt, Dockerfile.dev) sau e într-un subfolder. Intră în folderul corect sau arată-i fișierul cu -f: docker build -f docker/Dockerfile -t api:1.0 .

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

Ce înseamnă

La docker build -t api:1.0 ., punctul este contextul de build, iar Docker caută în el implicit fișierul Dockerfile (cu D mare, fără extensie). Primul pas al build-ului, load build definition from Dockerfile, eșuează imediat dacă fișierul nu e acolo, cu transferring dockerfile: 2B.

Cauzele frecvente: rulezi comanda din folderul greșit (cd uitat); editorul pe Windows a salvat fișierul ca Dockerfile.txt, cu extensia ascunsă; numele e dockerfile cu literă mică pe un sistem care face diferența; proiectul ține Dockerfile-ul într-un subfolder (docker/Dockerfile) sau are mai multe (Dockerfile.dev, Dockerfile.prod).

Opțiunea -f separă cele două lucruri: -f spune unde e Dockerfile-ul, iar ultimul argument rămâne contextul, folderul din care COPY ia fișiere.

De ce apare: cauzele frecvente

1Comanda rulată din alt folder

Greșit
BASH
cd ~
docker build -t api:1.0 .
Corect
BASH
cd ~/api
docker build -t api:1.0 .

Punctul înseamnă folderul curent. Din folderul proiectului, Docker găsește Dockerfile-ul.

2Dockerfile în subfolder sau cu alt nume

Greșit
BASH
ls docker/
# Dockerfile
docker build -t api:1.0 .
Corect
BASH
docker build -f docker/Dockerfile -t api:1.0 .

-f indică fișierul, iar contextul rămâne rădăcina proiectului, ca să funcționeze COPY.

3Extensie ascunsă pe Windows

Greșit
BASH
dir
# Dockerfile.txt
Corect
BASH
ren Dockerfile.txt Dockerfile

Docker caută numele exact Dockerfile, fără extensie.

Repară tu

Repară eroarea, direct în pagină

În proiectul ~/api, Dockerfile-ul e în subfolderul docker/, iar docker build -t api:1.0 . rulat din ~/api dă failed to read dockerfile: open Dockerfile. Construiește imaginea api:1.0 folosind fișierul docker/Dockerfile, cu contextul rădăcina proiectului (ca COPY server.js să găsească fișierul).

Indiciu

Opțiunea -f primește calea Dockerfile-ului; punctul de la final rămâne contextul.

Alte forme ale mesajului

  • ERROR: failed to solve: failed to read dockerfile: open Dockerfile.dev: no such file or directory
  • unable to prepare context: unable to evaluate symlinks in Dockerfile path: lstat /home/ana/api/Dockerfile: no such file or directory
  • failed to solve with frontend dockerfile.v0: failed to read dockerfile: open /var/lib/docker/tmp/buildkit-mount123/Dockerfile: no such file or directory

Cum o eviți pe viitor

Ține Dockerfile-ul în rădăcina proiectului, cu numele exact Dockerfile, și rulează build-ul de acolo. Dacă ai mai multe, folosește mereu -f explicit (-f Dockerfile.prod) sau scrie comanda într-un script / compose.yaml (build: {context: ., dockerfile: docker/Dockerfile}). Pe Windows, activează afișarea extensiilor în Explorer.

Întrebări frecvente

Cu -f, contextul se schimbă?

Nu. -f spune doar unde e Dockerfile-ul. Contextul e ultimul argument (de obicei .), iar COPY ia fișierele relativ la el, nu la folderul Dockerfile-ului.

Contează literele mari?

Pe Linux da: dockerfile nu e găsit implicit. Pe Windows și macOS, sistemul de fișiere ignoră de obicei diferența, dar e mai sigur să folosești numele standard.

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.