Docker Compose einrichten und einen ersten Dienst starten

Docker Compose auf Linux prüfen, eine compose.yaml schreiben, den ersten Container starten und Logs sowie Volumes verstehen.

Mit Docker Compose beschreibst du Container, Ports und Datenträger in einer compose.yaml. In diesem Beispiel startest du einen lokalen Webserver, prüfst seine Konfiguration und stoppst ihn wieder. Die Schritte gelten für einen Linux-Rechner mit Docker Engine und dem Compose-Plugin.

Vier Schritte: Compose-Datei definieren, Dienst starten, Container und Volume prüfen und localhost aufrufen.

Als nächstes Compose-Projekt eignet sich ein lokaler n8n-Dienst mit einem einfachen Test-Workflow. n8n mit Docker Compose installieren

1. Docker Engine und Compose prüfen

docker version
docker compose version

Fehlt das Compose-Kommando, installiere das Plugin nach der Docker-Anleitung für Linux. Melde einen Fehler am Docker-Socket getrennt von einem fehlenden Plugin. Mitgliedschaft in der Docker-Gruppe gibt weitreichende Rechte auf dem Host.

2. Compose-Datei anlegen

Lege einen Projektordner an und speichere darin die folgende Datei als compose.yaml. Der Webserver ist mit dieser Portbindung nur auf demselben Rechner erreichbar.

services:
  web:
    image: nginx:alpine
    ports:
      - "127.0.0.1:8080:80"

3. Dienst starten und testen

docker compose config
docker compose up -d
docker compose ps
curl http://127.0.0.1:8080/
docker compose logs --tail=30 web

Du solltest eine Antwort des Webservers sehen. Meldet Docker einen belegten Port, ändere links in der Portbindung 8080 auf einen freien Hostport und verwende diesen auch beim Test. Die rechte Zahl 80 ist der Port im Container.

4. Konfiguration und Daten sichern

Speichere deine Compose-Datei und gegebenenfalls die zugehörigen Konfigurationsdateien. Für dauerhafte Anwendungsdaten nutzt du ein benanntes Volume oder einen geeigneten Hostordner. Sichere diese Daten separat und halte Zugangsdaten aus Versionskontrolle und öffentlichen Kopien heraus.

docker compose down

Der Befehl entfernt Container und das Standardnetzwerk des Projekts. Verwende down -v nur, wenn du die Projekt-Volumes bewusst löschen willst. Das offizielle Compose-Tutorial zeigt anschließend mehrere Dienste und Healthchecks. Praxisbeispiele sind Jellyfin als Medienserver, Pi-hole als DNS-Filter und die Immich-Installation fürs Fotobackup. Für die Verwaltung im Browser gibt es unsere Portainer-Anleitung.

Häufige Fragen

Was ist der Unterschied zwischen Docker Compose und Docker Engine?

Die Engine führt Container aus. Compose verwaltet mit einer Konfigurationsdatei, welche Dienste, Netzwerke und Volumes gemeinsam dazugehören.

Warum verwende ich docker compose ohne Bindestrich?

Das ist der Aufruf für das aktuelle Compose-Plugin. Das ältere eigenständige docker-compose ist in manchen historischen Anleitungen noch zu sehen.

Bleiben Daten nach docker compose down erhalten?

Benannte Volumes und Hostordner bleiben beim normalen down grundsätzlich erhalten. Daten im beschreibbaren Container-Dateisystem können mit dem Container verloren gehen.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert

CPU Vergleich

Aktuelle Beiträge

Technikaffe.de

Wir von Technikaffe.de schreiben über Mini-PCs, XBMC / Kodi Mediaplayer und NAS. Spezialisiert haben wir uns vor allem auf sparsame Hardware. Bei Fragen und Feedback kontaktiert uns gerne über die Kommentarfunktion, wir lesen täglich mit und antworten in der Regel binnen 24 Stunden.

© Copyright 2026 Technikaffe.de