docker: 'compose' is not a docker command.
Clientul docker nu are pluginul Compose v2, deci nu știe subcomanda compose. Instalează pluginul (pe Ubuntu: sudo apt install docker-compose-plugin) sau Docker Desktop. Invers, dacă ai doar v2, docker-compose (cu cratimă) nu există: scrie docker compose, cu spațiu.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Docker Compose există în două forme. Compose v1 era un program separat, docker-compose (cu cratimă), scris în Python, scos din uz în 2023. Compose v2 e un plugin al clientului docker și se apelează docker compose (cu spațiu). Docker Desktop îl include, iar pe Linux vine în pachetul docker-compose-plugin.
'compose' is not a docker command înseamnă că clientul nu găsește pluginul: ai instalat doar docker.io din depozitele distribuției, fără plugin, sau un client vechi. Simptomul înrudit: docker compose up -d dă unknown shorthand flag: 'd' in -d, pentru că, fără plugin, clientul încearcă să interpreteze opțiunile singur.
Problema inversă e la fel de frecventă: tutorialele vechi folosesc docker-compose up, iar pe un sistem nou primești docker-compose: command not found. Fișierul compose e același; schimbi doar comanda.
De ce apare: cauzele frecvente
1Pluginul Compose nu e instalat (Linux)
sudo apt install docker.io
docker compose up -dsudo apt install docker-compose-plugin
docker compose versionPachetul docker-compose-plugin (din depozitul Docker) adaugă subcomanda compose.
2Comanda v1 pe un sistem doar cu v2
docker-compose up -d
# docker-compose: command not founddocker compose up -dÎn v2, compose e subcomandă a lui docker, scrisă cu spațiu.
3Scripturi vechi care cheamă docker-compose
#!/bin/sh
docker-compose pull
docker-compose up -d#!/bin/sh
docker compose pull
docker compose up -dÎnlocuiești comanda în scripturi; opțiunile și fișierul compose rămân aceleași.
Repară eroarea, direct în pagină
În ~/blog, scriptul vechi de pornire rulează docker-compose up -d, iar terminalul răspunde docker-compose: command not found, pentru că pe calculator e instalat Compose v2. Verifică versiunea de Compose și pornește proiectul blog în fundal cu comanda corectă.
Indiciu
În Compose v2, comanda e docker compose (cu spațiu).
Reparația
docker compose versionDocker Compose version v2.29.7docker compose up -d
docker compose psDe ce merge
Compose v2 nu instalează executabilul docker-compose, ci adaugă subcomanda compose clientului docker. docker compose version confirmă că pluginul există și ce versiune are, iar docker compose up -d citește același compose.yaml și pornește în fundal serviciul web al proiectului blog. Fișierul nu trebuie schimbat deloc.
Alte forme ale mesajului
docker: 'compose' is not a docker command. See 'docker --help'docker-compose: command not foundCommand 'docker-compose' not found, but can be installed with:
Cum o eviți pe viitor
Instalează Docker din depozitul oficial (docker-ce, docker-ce-cli, docker-compose-plugin), nu doar pachetul docker.io al distribuției. Verifică cu docker compose version pe orice calculator nou. În documentația și scripturile proiectului, folosește forma docker compose, iar dacă ai nevoie temporar de vechiul nume, un alias (alias docker-compose='docker compose').
Întrebări frecvente
Fișierul docker-compose.yml merge și cu v2?
Da. Compose v2 citește compose.yaml, compose.yml, docker-compose.yaml și docker-compose.yml. Doar cheia version: de la început e ignorată (și produce un avertisment).
Pot instala pip install docker-compose?
Poți, dar e versiunea 1, care nu mai primește actualizări. Pluginul v2 e varianta întreținută.
Erori înrudite
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. unknown shorthand flag: 'f' in -f Opțiunea scurtă nu există pentru această comandă docker (de exemplu docker stop nu are -f). Citește docker <comandă> --help și folosește opțiunea sau comanda potrivită: pentru oprire forțată, docker kill sau docker rm -f. Dacă apare la docker compose up -d, lipsește pluginul Compose. WARN[0000] /home/ana/magazin/docker-compose.yml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion E doar un avertisment: Compose v2 nu mai folosește cheia version: de la începutul fișierului și o ignoră. Șterge linia version: "3.8" (sau oricare) din compose.yaml; restul fișierului rămâne la fel și proiectul pornește ca înainte. Î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.
