...
Eroare Docker · Docker Compose

no configuration file provided: not found

Pe scurt

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.

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

Ce înseamnă

Fără -f, docker compose caută în folderul curent (și apoi în folderele părinte) un fișier cu unul din numele standard: compose.yaml, compose.yml, docker-compose.yaml, docker-compose.yml. Dacă nu găsește niciunul, se oprește cu acest mesaj, indiferent de comandă (up, ps, logs, down).

Cauzele frecvente: rulezi comanda din alt folder (de exemplu din ~ după ce ai deschis un terminal nou), fișierul are alt nume (compose.yml.txt salvat de un editor pe Windows, docker_compose.yml, Compose.yaml pe un sistem sensibil la majuscule) sau fișierul nu există încă.

Numele folderului contează și pentru altceva: el devine numele proiectului (prefixul containerelor, rețelelor și volumelor), deci rularea din alt folder cu -f păstrează numele proiectului după folderul fișierului.

De ce apare: cauzele frecvente

1Comanda rulează din alt folder

Greșit
BASH
cd ~
docker compose up -d
Corect
BASH
cd ~/blog
docker compose up -d

Compose caută fișierul în folderul curent. Din folderul proiectului, îl găsește.

2Fișierul are un nume nestandard

Greșit
BASH
ls
# stack.yml
docker compose up -d
Corect
BASH
docker compose -f stack.yml up -d
# sau redenumește-l:
mv stack.yml compose.yaml

Doar numele standard sunt găsite automat. Altfel, fișierul se dă cu -f.

3Extensie ascunsă adăugată de editor

Greșit
BASH
ls
# compose.yaml.txt
Corect
BASH
mv compose.yaml.txt compose.yaml

Unele editoare adaugă .txt, iar exploratorul de fișiere ascunde extensia. ls arată numele real.

Repară tu

Repară eroarea, direct în pagină

Proiectul blogului e în ~/blog, cu compose.yaml gata scris, dar docker compose up -d rulat din folderul personal dă no configuration file provided: not found. Pornește proiectul blog și verifică pagina pe localhost:8080.

Indiciu

Compose caută fișierul în folderul curent; intră întâi în folderul proiectului (sau dă fișierul cu -f).

Alte forme ale mesajului

  • no configuration file provided: not found
  • Can't find a suitable configuration file in this directory or any parent. Are you in the right directory?
  • open /home/ana/blog/docker-compose.yml: no such file or directory

Cum o eviți pe viitor

Deschide terminalul direct în folderul proiectului (în VS Code, terminalul integrat pornește deja acolo) și folosește numele standard compose.yaml. Dacă lucrezi cu mai multe fișiere (dev, prod), setează în .env variabila COMPOSE_FILE=compose.yaml:compose.dev.yaml, ca să nu mai dai -f la fiecare comandă. docker compose ls îți arată proiectele pornite și fișierele lor.

Întrebări frecvente

Ce nume de fișier e recomandat?

compose.yaml. docker-compose.yml merge în continuare pentru compatibilitate, dar documentația actuală folosește compose.yaml.

Pot opri un proiect din alt folder?

Da: docker compose -p blog down folosește numele proiectului, sau docker compose -f ~/blog/compose.yaml down folosește fișierul.

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.