Docker Compose: Befehl nicht gefunden

Sie haben docker-compose up -d auf einem Rechner ausgeführt, auf dem genau dieser Befehl schon ein Dutzend Mal funktioniert hat - oder auf einem frisch geflashten Pi, oder einem gerade neu gestarteten Synology-NAS - und die Shell antwortet mit docker-compose: command not found. Docker selbst ist offensichtlich installiert; docker ps funktioniert einwandfrei. Was ist also kaputt?

Warum das passiert: Ihnen fehlt V2, nicht Docker Compose selbst

Compose V1 - das eigenständige docker-compose-Python-Binary - erhielt seit Juli 2023 keine Updates mehr und wurde aus neuen Docker-Desktop-Versionen entfernt. Es wurde durch Compose V2 ersetzt, ein Docker-CLI-Plugin, aufgerufen als docker compose - ein Leerzeichen, wo früher ein Bindestrich stand. Dockers eigener Migrationsleitfaden bestätigt, dass V2 funktional ein direkter Ersatz für V1 ist, abgesehen von der Syntaxänderung.

Wenn Sie Docker in den letzten Jahren über einen offiziellen Kanal installiert haben - Docker Engines apt-Repo, Docker Desktop, oder ein aktuelles Distro-Paket - haben Sie mit großer Sicherheit nur V2. Das docker-compose-Binary war nie da. Der Fehler bedeutet nicht "Compose fehlt", sondern "der konkrete Befehl, den Sie eingegeben haben, fehlt".

Der 30-Sekunden-Check

Bevor Sie irgendetwas ändern, klären Sie zuerst, welcher Fall bei Ihnen vorliegt:

docker compose version     # V2 - das Plugin, ohne Bindestrich
docker-compose --version   # V1 - das alte eigenständige Binary

Gibt der erste Befehl eine Version aus, haben Sie Compose, und es ist reine Syntax - jeder Befehl in jedem Skript, Alias und jeder eingeübten Gewohnheit braucht statt des Bindestrichs ein Leerzeichen. Schlagen beide Befehle fehl, springen Sie direkt zum Abschnitt "Immer noch nicht gefunden" weiter unten - das ist ein echtes Installations- oder PATH-Problem, nicht der V1/V2-Wechsel.

Beheben unter Debian und Ubuntu

sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version

Beheben auf Raspberry Pi OS

Ich habe vor einiger Zeit mehrere Dienste von einem älteren Raspberry Pi auf eine Debian-Maschine umgezogen, und die alte Installationsanleitung, die ich mir gemerkt hatte - pip3 install docker-compose - installierte V1, genau das jetzt veraltete Binary. Raspberry Pi OS' ARM-Architektur wird vom docker-compose-plugin-apt-Paket von Debian/Ubuntu ebenfalls nicht bedient, daher ist der saubere Weg auf einem Pi Dockers eigenes Komfort-Skript, das die ARM-Architektur erkennt und direkt das aktuelle V2-Plugin installiert:

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
docker compose version

Überspringen Sie jede Anleitung, die 2026 noch pip3 install docker-compose auf einem Pi empfiehlt - dieser Weg installiert einen unsupporteten V1-Build ohne weitere Sicherheitsupdates.

Beheben auf Synology (Container Manager)

Das ist der Fall, den die meisten Troubleshooting-Anleitungen komplett auslassen, weil Synology nicht wie eine normale Linux-Installation funktioniert. DSM 7.2 benannte das Docker-Paket in Container Manager um, und Compose läuft über dessen Projekt-Tab im DSM-Webinterface oder per SSH als docker compose - es gibt kein separates docker-compose-Binary zum Installieren, weil Synology gar kein apt zur Verfügung stellt.

So führen Sie Compose auf einem Synology-NAS über die Kommandozeile aus:

1. SSH aktivieren unter Systemsteuerung → Terminal & SNMP.
2. Per SSH einloggen: ssh <ihr-benutzername>@<nas-ip>.
3. Compose ausführen mit sudo docker compose -f /pfad/zur/compose.yaml up -d - beachten Sie das Leerzeichen, und dass DSM in manchen Projekt-Tab-Versionen compose.yaml statt des älteren Namens docker-compose.yml erwartet.

Immer noch nicht gefunden? PATH prüfen

Seltener, aber durchaus real: Das Plugin oder Binary liegt tatsächlich auf der Festplatte, aber die PATH-Variable Ihrer Shell enthält das Verzeichnis nicht, in dem es liegt. Finden Sie es zuerst:

sudo find / -name docker-compose 2>/dev/null

Liefert das einen Pfad wie /usr/local/bin/docker-compose, fügen Sie entweder dieses Verzeichnis zu PATH hinzu (export PATH="$PATH:/usr/local/bin" an ~/.bashrc oder ~/.zshrc anhängen), oder verlinken Sie es in ein Verzeichnis, das bereits im PATH liegt:

sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

Alte docker-compose-Skripte am Laufen halten

Haben Sie CI-Jobs, Deploy-Skripte oder eingeübte Gewohnheiten, die noch docker-compose mit Bindestrich aufrufen, und eine Überarbeitung aller Stellen ist heute nicht realistisch, überbrückt eine einzeilige Shell-Funktion die Lücke ohne Neuinstallation:

echo 'docker-compose() { docker compose "$@"; }' >> ~/.bashrc
source ~/.bashrc

FAQ

Fazit

Fast jeder docker-compose: command not found-Fehler führt auf genau dieses Datum zurück - Sie sind auf einem System, das immer nur V2 hatte, und der Bindestrich-Befehl existiert dort schlicht nicht. Bestätigen Sie das mit docker compose version, bevor Sie irgendetwas neu installieren, und folgen Sie dann dem passenden Weg für Ihr System oben. Bauen Sie gerade erst Ihren ersten Stack auf, statt einen bestehenden zu reparieren, setzt unser Leitfaden zu Docker Compose für Self-Hosting einen Schritt früher an - und wenn danach Container in der falschen Reihenfolge neu starten, erklärt unser Leitfaden zu Docker-Compose-Restart-Policies das nächste Problem.