Wie nutze ich Docker Compose auf einem Ubuntu- oder Debian-VPS?
Eine compose.yaml schreiben, WordPress und MariaDB mit docker compose up -d starten und anschließend Logs, Updates, Backups und HTTPS auf einem Linux-VPS
Docker Compose beschreibt mehrere Container in einer einzigen Datei, compose.yaml: Images, Ports, Volumes, Variablen und Startreihenfolge. Ein einziger Befehl, docker compose up -d, erstellt oder aktualisiert den gesamten Stack. Diese Anleitung geht von einem VPS aus, auf dem Docker bereits installiert ist, baut ein konkretes Beispiel auf, WordPress mit MariaDB, und erklärt dann die Befehle für den Alltag und die häufigsten Fehler. Sie gilt unverändert für Ubuntu 22.04 / 24.04 und Debian 12 / 13.
Schritt-für-Schritt-Anleitung
-
Docker und das Compose-Plugin prüfen
Führen Sie docker compose version aus. Lautet die Antwort docker: 'compose' is not a docker command, installieren Sie Docker aus dem offiziellen Repository mit dem Paket docker-compose-plugin, wie in der Anleitung zur Docker-Installation beschrieben.
-
Projektordner anlegen
Legen Sie pro Anwendung einen Ordner an, zum Beispiel /opt/wordpress, und wechseln Sie hinein. Compose benennt das Projekt nach diesem Ordner und sucht compose.yaml im aktuellen Ordner.
-
Die Dateien .env und compose.yaml schreiben
Erzeugen Sie ein Passwort in .env, das nur root lesen kann, und kopieren Sie dann die Datei compose.yaml unten. Beim Start ersetzt Compose ${DB_PASSWORD} durch den Wert aus .env.
-
Den Stack starten
Führen Sie docker compose up -d aus. Compose lädt die Images herunter, erstellt Netzwerk und Volumes, wartet, bis MariaDB bereit ist, und startet dann WordPress. docker compose ps zeigt anschließend beide Dienste als Up, mit (healthy) für db.
-
Testen und Logs lesen
Auf dem VPS muss curl -I http://127.0.0.1:8080 eine Weiterleitung zur Installationsseite von WordPress liefern. Bei Problemen zeigt docker compose logs -f --tail=100 die Logs aller Dienste.
-
Container aktualisieren
Für eine neue Version ändern Sie den Image-Tag in compose.yaml und führen dann docker compose pull und docker compose up -d aus: Nur Container, deren Image oder Konfiguration sich geändert hat, werden neu erstellt, die Volumes bleiben erhalten.
Projekt und Passwort anlegen
mkdir -p /opt/wordpress
cd /opt/wordpress
echo "DB_PASSWORD=$(openssl rand -hex 24)" > .env
chmod 600 .env
Datei compose.yaml: WordPress und MariaDB
services:
db:
image: mariadb:11.4
restart: unless-stopped
environment:
MARIADB_DATABASE: wordpress
MARIADB_USER: wordpress
MARIADB_PASSWORD: ${DB_PASSWORD}
MARIADB_RANDOM_ROOT_PASSWORD: "1"
volumes:
- db_data:/var/lib/mysql
healthcheck:
test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
interval: 10s
timeout: 5s
retries: 5
wordpress:
image: wordpress:6.8-apache
restart: unless-stopped
depends_on:
db:
condition: service_healthy
environment:
WORDPRESS_DB_HOST: db
WORDPRESS_DB_USER: wordpress
WORDPRESS_DB_PASSWORD: ${DB_PASSWORD}
WORDPRESS_DB_NAME: wordpress
ports:
- "127.0.0.1:8080:80"
volumes:
- wp_data:/var/www/html
volumes:
db_data:
wp_data:
Starten und prüfen
docker compose up -d
docker compose ps
curl -I http://127.0.0.1:8080
docker compose logs -f --tail=100
Docker-Compose-Befehle für den Alltag
docker compose ps
docker compose logs --tail=50 wordpress
docker compose restart wordpress
docker compose exec db sh
docker compose stop
docker compose start
docker compose down
docker compose config --quiet
docker compose ls
Images aktualisieren
cd /opt/wordpress
docker compose pull
docker compose up -d
docker image prune -f
MariaDB-Datenbank sichern
cd /opt/wordpress
docker compose exec -T db sh -c 'mariadb-dump -u"$MARIADB_USER" -p"$MARIADB_PASSWORD" "$MARIADB_DATABASE"' > wordpress-$(date +%F).sql
HTTPS mit Caddy: compose.override.yaml
services:
caddy:
image: caddy:2
restart: unless-stopped
ports:
- "80:80"
- "443:443"
- "443:443/udp"
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy_data:/data
- caddy_config:/config
volumes:
caddy_data:
caddy_config:
Caddyfile
example.com {
reverse_proxy wordpress:80
}
Bevor Sie beginnen
Sie brauchen einen Linux-VPS mit Docker Engine und dem Compose-Plugin, installiert aus dem offiziellen Docker-Repository: Folgen Sie der Anleitung „Wie installiere ich Docker auf Debian 12 oder Ubuntu 24.04?“, falls das noch nicht erledigt ist. Die Befehle werden als root ausgeführt; ein Konto in der Gruppe docker kann sie auch ohne sudo ausführen.
- Compose v2 schreibt man docker compose, mit Leerzeichen. Das alte Programm docker-compose (v1) wird seit 2023 nicht mehr gepflegt: Installieren Sie es weder mit pip noch mit apt.
- Die Datei heißt compose.yaml; docker-compose.yml wird für ältere Projekte weiterhin gelesen. Die Zeile version: am Dateianfang ist veraltet und hat keine Funktion mehr.
- WordPress und MariaDB kommen mit 1 bis 2 GB RAM aus; planen Sie mehr ein, sobald mehrere Stacks auf demselben VPS laufen.
Die Datei compose.yaml verstehen
Jeder Eintrag unter services wird zu einem Container. Compose erstellt außerdem ein privates Netzwerk für das Projekt: Die Dienste erreichen sich dort über ihren Namen, daher WORDPRESS_DB_HOST: db. Kein Port von MariaDB wird veröffentlicht, die Datenbank bleibt also aus dem Internet unsichtbar.
- image: das Image und sein Tag. Legen Sie eine Version fest (mariadb:11.4) statt latest, damit Sie wissen, was Sie aktualisieren.
- ports: "127.0.0.1:8080:80" veröffentlicht Port 80 des Containers auf Port 8080 des VPS, nur lokal. Ohne 127.0.0.1 ist der Port aus dem Internet erreichbar, selbst wenn UFW ihn sperrt.
- volumes: Ein benanntes Volume (db_data) behält die Daten, wenn der Container neu erstellt wird. Es wird nur durch docker compose down -v oder docker volume rm gelöscht.
- environment und .env: Geheimnisse bleiben in .env, außerhalb der Datei, die Sie teilen oder versionieren.
- restart: unless-stopped startet die Container nach einem Absturz oder einem Neustart des VPS wieder, außer denen, die Sie von Hand gestoppt haben.
- depends_on mit condition: service_healthy wartet, bis der healthcheck von MariaDB erfolgreich ist, bevor WordPress startet.
Die Website per HTTPS online stellen
Um die Website unter einem Domainnamen auszuliefern, richten Sie einen A-Record auf die IPv4-Adresse des VPS, öffnen die Ports 80 und 443 und fügen dann Caddy in einer Datei compose.override.yaml hinzu, die Compose automatisch zusammen mit compose.yaml liest. Ersetzen Sie example.com im Caddyfile durch Ihre Domain: Caddy holt und erneuert das Let’s-Encrypt-Zertifikat selbstständig.
Schließen Sie die Installation von WordPress anschließend über die https-Adresse Ihrer Domain ab, nicht über 127.0.0.1: WordPress speichert die Adresse, die bei der Installation verwendet wurde.
Backups und Updates des Stacks
Ein Volume ist kein Backup: Es verschwindet mit dem VPS oder durch ein versehentlich ausgeführtes down -v. Exportieren Sie die Datenbank mit mariadb-dump (Block oben), kopieren Sie den Projektordner und den Inhalt der Volumes und übertragen Sie alles auf ein System außerhalb des VPS.
- docker compose pull lädt die neuen Images der angegebenen Tags herunter, docker compose up -d erstellt die betroffenen Container neu und docker image prune -f gibt den Platz der alten Images frei.
- Bevor Sie auf eine neue Hauptversion von MariaDB oder PostgreSQL wechseln, erstellen Sie einen SQL-Export: Die neue Version kann eine Migration der Daten erfordern.
- docker system df zeigt, wie viel Platz Images, Container und Volumes belegen.
Welcher VPS für Docker Compose?
Docker braucht einen echten Linux-Kernel: Ein KVM-VPS eignet sich, ein Shared Hosting nicht. Bei ACLClouds kostet der VPS Mini (2 vCPU, 8 GB RAM, 40 GB Speicher) mit Stand 16. November 2026 4,99 € pro Monat ohne Mindestlaufzeit oder 3,99 € pro Monat bei einer Laufzeit von einem Jahr: Er betreibt mehrere kleine Compose-Stacks. Der VPS Essentiel (4 vCPU, 16 GB RAM, 80 GB) für 9,99 € pro Monat eignet sich für eine stark genutzte Datenbank oder n8n neben einer Website.
Die Option -v von docker compose down löscht Daten
docker compose down -v löscht auch die benannten Volumes des Projekts, also die MariaDB-Datenbank und die WordPress-Dateien. Erstellen Sie vor jedem Befehl mit -v einen Export.
Schnellüberprüfung
- docker compose version antwortet ohne Fehler.
- docker compose ps zeigt db als (healthy) und wordpress als Up.
- Port 8080 ist nur auf 127.0.0.1 veröffentlicht.
- .env hat den Modus 600 und liegt in keinem Git-Repository.
- Ein aktueller SQL-Export liegt außerhalb des VPS.
Häufig gestellte Fragen
Warum erscheint no configuration file provided: not found?
Compose findet im aktuellen Ordner weder compose.yaml noch docker-compose.yml. Wechseln Sie mit cd /opt/wordpress in den Projektordner oder geben Sie die Datei mit docker compose -f /opt/wordpress/compose.yaml up -d an.
Compose zeigt „the attribute version is obsolete“ an: Ist das schlimm?
Nein, das ist nur eine Warnung. Compose v2 ignoriert die Zeile version: "3.8" am Dateianfang: Löschen Sie sie, damit die Warnung verschwindet, der Rest der Datei bleibt unverändert.
Warum erscheint beim Start port is already allocated oder address already in use?
Ein anderer Container veröffentlicht diesen Port bereits, oder ein Dienst des VPS (nginx, Apache) lauscht darauf. Finden Sie ihn mit docker ps --filter publish=80 und ss -tlnp | grep :80, stoppen Sie ihn dann oder ändern Sie den linken Port unter ports, zum Beispiel "8081:80".
Warum erscheint docker: 'compose' is not a docker command?
Das Compose-v2-Plugin ist nicht installiert. Mit dem offiziellen Docker-Repository führen Sie apt install docker-compose-plugin aus. Die Pakete docker.io und docker-compose der Distributionen sind veraltet oder liefern nur den alten Befehl mit Bindestrich.
Warum werden meine Änderungen an compose.yaml nicht übernommen?
docker compose restart startet die Container neu, ohne die Datei erneut zu lesen. Führen Sie docker compose up -d aus: Compose vergleicht die Konfiguration und erstellt die geänderten Dienste neu. Prüfen Sie die Datei vorher mit docker compose config.
Sind meine Daten nach docker compose down verschwunden?
Nein: docker compose down entfernt die Container und das Netzwerk, nicht die benannten Volumes. Daten gehen nur mit down -v verloren oder wenn sie ohne Volume in den Container geschrieben wurden. docker volume ls listet die Volumes auf, mit dem Projektnamen als Präfix, zum Beispiel wordpress_db_data.
Was ist nach yaml: line 8: mapping values are not allowed in this context zu korrigieren?
Die YAML-Datei ist falsch eingerückt: ein Tabulator statt Leerzeichen oder eine verschobene Ebene. Verwenden Sie nur Leerzeichen (zwei pro Ebene), setzen Sie Werte mit : wie Ports in Anführungszeichen und prüfen Sie dann mit docker compose config.