...
Eroare Docker · Docker Compose

unable to prepare context: path "/home/ana/magazin/api" not found

Pe scurt

Folderul dat la build: în compose.yaml (sau ca context la docker build) nu există la acea cale. Căile sunt relative la folderul compose.yaml: verifică numele real cu ls (backend, nu api; litere mari) și corectează build: ./backend.

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

Ce înseamnă

build: ./api îi spune lui Compose să construiască imaginea serviciului din folderul api, aflat lângă compose.yaml. Înainte de build, clientul pregătește contextul, adică arhivează folderul pentru BuildKit. Dacă folderul nu există, se oprește aici, cu calea absolută în mesaj.

Motivele obișnuite: folderul are alt nume (backend, API, pe Linux literele mari contează); ai mutat compose.yaml într-un subfolder, iar căile relative acum pornesc din alt loc; folderul e un submodul Git care n-a fost descărcat (git submodule update --init); scrii o cale absolută de pe calculatorul unui coleg.

Același mesaj îl dă docker build cale când calea nu există. Compară calea din mesaj cu ls din folderul proiectului.

De ce apare: cauzele frecvente

1Folderul are alt nume

Greșit
BASH
services:
  api:
    build: ./api
# în proiect: backend/
Corect
BASH
services:
  api:
    build: ./backend

Calea trebuie să fie folderul real cu Dockerfile-ul.

2compose.yaml mutat în subfolder

Greșit
BASH
# deploy/compose.yaml
services:
  api:
    build: ./backend
Corect
BASH
# deploy/compose.yaml
services:
  api:
    build: ../backend

Căile din compose.yaml sunt relative la folderul fișierului.

3Submodul Git nedescărcat

Greșit
BASH
git clone https://git.firma.ro/magazin.git
docker compose build
Corect
BASH
git submodule update --init
docker compose build

Folderul submodulului e gol sau lipsește până îl descarci.

Repară tu

Repară eroarea, direct în pagină

În ~/magazin, compose.yaml construiește serviciul api cu build: ./api, dar codul și Dockerfile-ul sunt în folderul backend, iar docker compose up -d dă unable to prepare context: path "/home/elev/magazin/api" not found. Repară calea și pornește proiectul (imaginea se construiește din backend).

Indiciu

ls în folderul proiectului; apoi build: ./backend.

Alte forme ale mesajului

  • ERROR: unable to prepare context: path "/home/ana/magazin/api" not found
  • unable to prepare context: path "./api" not found
  • failed to solve: failed to read dockerfile: open Dockerfile: no such file or directory

Cum o eviți pe viitor

Ține compose.yaml în rădăcina proiectului, cu căi relative scurte (./backend). Verifică cu docker compose config, care afișează căile absolute rezolvate pentru fiecare build.context, deci vezi imediat un folder greșit. După clonare, rulează git submodule update --init dacă proiectul are submodule.

Întrebări frecvente

Pot da și un alt Dockerfile la build?

Da, cu forma lungă: build: {context: ./backend, dockerfile: docker/Dockerfile.prod}. Calea dockerfile e relativă la context.

Pot construi direct dintr-un repository Git?

Da, build: https://github.com/firma/api.git#main folosește repository-ul ca context. E util pentru unelte, dar pentru codul tău e mai clar un folder local.

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.