...
Eroare Docker · Docker Compose

docker: 'compose' is not a docker command.

Pe scurt

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)

Greșit
BASH
sudo apt install docker.io
docker compose up -d
Corect
BASH
sudo apt install docker-compose-plugin
docker compose version

Pachetul docker-compose-plugin (din depozitul Docker) adaugă subcomanda compose.

2Comanda v1 pe un sistem doar cu v2

Greșit
BASH
docker-compose up -d
# docker-compose: command not found
Corect
BASH
docker compose up -d

În v2, compose e subcomandă a lui docker, scrisă cu spațiu.

3Scripturi vechi care cheamă docker-compose

Greșit
BASH
#!/bin/sh
docker-compose pull
docker-compose up -d
Corect
BASH
#!/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ă tu

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

Alte forme ale mesajului

  • docker: 'compose' is not a docker command. See 'docker --help'
  • docker-compose: command not found
  • Command '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

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