docker compose¶
Startet, aktualisiert und stoppt einen ganzen Stack von Containern, der in einer compose.yaml beschrieben ist.

Syntax¶
docker compose [-f DATEI] BEFEHL [OPTIONEN] [DIENST...]
Optionen¶
| Option | Beschreibung |
|---|---|
up -d |
Alle Dienste im Hintergrund anlegen und starten; geänderte Dienste werden neu angelegt |
down |
Die Container und das Netzwerk stoppen und entfernen (Volumes bleiben, außer mit -v) |
ps |
Die Container des Projekts zeigen |
logs [-f] [DIENST] |
Die Ausgabe aller oder einzelner Dienste zeigen |
pull |
Neuere Versionen der Images herunterladen |
restart [DIENST] |
Dienste neu starten |
exec DIENST BEFEHL |
Einen Befehl im Container eines Dienstes ausführen |
config |
Die Datei prüfen und die vollständige Konfiguration zeigen |
-f DATEI |
Eine andere Datei statt compose.yaml im aktuellen Verzeichnis |
Beispiele¶
Den Stack aus der compose.yaml starten:
cd /srv/status
docker compose up -d
[+] up 4/4
✔ Network status_default Created 0.0s
✔ Volume status_dbdata Created 0.0s
✔ Container status-web-1 Started 0.3s
✔ Container status-db-1 Started 0.5s
Compose benennt alles nach dem Verzeichnis (status) und dem Dienst. Die Datei selbst steht in den Grundlagen.
Die Container des Projekts:
docker compose ps
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
status-db-1 postgres:17 "docker-entrypoint.s…" db 2 minutes ago Up 2 minutes 5432/tcp
status-web-1 nginx:1.28 "/docker-entrypoint.…" web 2 minutes ago Up 2 minutes 0.0.0.0:8080->80/tcp, [::]:8080->80/tcp
Die Logs aller Dienste:
docker compose logs --tail 2
web-1 | 2026/10/26 09:40:05 [notice] 1#1: start worker process 29
web-1 | 2026/10/26 09:40:05 [notice] 1#1: start worker process 30
db-1 | 2026-10-26 09:40:07.102 UTC [1] LOG: database system is ready to accept connections
db-1 | 2026-10-26 09:40:07.104 UTC [62] LOG: database system was shut down at 2026-10-26 09:40:06 UTC
Alle Dienste aktualisieren:
docker compose pull
docker compose up -d
[+] pull 2/2
✔ Image postgres:17 Pulled 1.7s
✔ Image nginx:1.28 Pulled 1.6s
[+] up 2/2
✔ Container status-db-1 Running 0.0s
✔ Container status-web-1 Recreated 0.4s
Nur web hatte ein neues Image, deshalb wurde nur sein Container neu angelegt. db lief einfach weiter.
Den Stack stoppen und entfernen:
docker compose down
[+] down 3/3
✔ Container status-db-1 Removed 0.5s
✔ Container status-web-1 Removed 0.4s
✔ Network status_default Removed 0.1s
Das Volume status_dbdata bleibt erhalten, die Datenbank ist beim nächsten up also wieder da.
Wann brauche ich das?¶
- Für jeden Dienst, der aus mehr als einem Container besteht, etwa eine Anwendung mit Datenbank
- Um den Aufbau eines Servers in einer Datei zu dokumentieren, die ins Git-Repository kann
- Um alle Container eines Stacks mit zwei Befehlen zu aktualisieren
Einen Stack aktualisieren
docker compose pull und danach docker compose up -d bringt alle Dienste auf das
neueste Image ihres Tags. Neu angelegt werden nur Container, deren Image oder
Konfiguration sich geändert hat.
docker-compose mit Bindestrich ist die alte Version
docker-compose (mit Bindestrich) ist Compose Version 1, die nicht mehr gepflegt wird.
Aktuell ist das Plugin docker compose (mit Leerzeichen). Die compose.yaml-Dateien
sind weitgehend gleich.
down -v löscht die Daten
docker compose down -v löscht auch die Volumes des Projekts und damit die Datenbank.
Lass -v weg, außer du willst wirklich bei null anfangen.
Unterschiede zwischen Distributionen¶
| Debian | Ubuntu | RHEL | Arch | |
|---|---|---|---|---|
| Befehl | docker compose (docker-compose-plugin) |
docker compose (docker-compose-plugin) |
docker compose (docker-compose-plugin) oder podman compose |
docker compose (docker-compose) |