Tutorials

Anleitung: Docker Compose auf Ubuntu Linux installieren

Melden

Docker Compose ist ein unverzichtbares Werkzeug für Entwickler und Systemadministratoren. Es ermöglicht Ihnen, Multi-Container-Docker-Anwendungen mithilfe einer einzigen YAML-Datei (docker-compose.yml) zu definieren und zu verwalten.

In dieser Anleitung erfahren Sie Schritt für Schritt, wie Sie Docker Compose auf Ubuntu Linux (und anderen Linux-Distributionen) installieren.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass:

  • Sie ein Linux-System (z. B. Ubuntu) nutzen.
  • Sie über ein Benutzerkonto mit sudo-Rechten verfügen.
  • Docker bereits installiert ist. (Docker Compose benötigt eine funktionierende Docker-Engine).

Methode 1: Installation als Docker CLI-Plugin (Empfohlen)

Docker Compose V2 ist die moderne Version von Docker Compose und wird direkt in das docker-Kommandozeilenwerkzeug integriert (Aufruf über docker compose statt docker-compose).

Schritt 1: Paketlisten aktualisieren

Öffnen Sie Ihr Terminal und bringen Sie die Paketliste auf den neuesten Stand:

sudo apt update

Schritt 2: Docker Compose Plugin installieren

Wenn Sie Docker bereits über das offizielle Docker-Repository installiert haben, können Sie das Compose-Plugin einfach über apt installieren:

sudo apt install docker-compose-plugin -y

Schritt 3: Installation überprüfen

Überprüfen Sie, ob Docker Compose erfolgreich installiert wurde:

docker compose version

Beispielausgabe:

Docker Compose version v2.x.x

Methode 2: Manuelle Installation der Standalone-Binärdatei (Universell für alle Linux-Distributionen)

Falls Sie die klassische, eigenständige Binärdatei bevorzugen (Aufruf über docker-compose mit Bindestrich) oder eine Distribution ohne das offizielle Docker-Repository nutzen, ist dieser Weg ideal.

Schritt 1: Docker Compose herunterladen

Laden Sie die aktuelle Version der Binärdatei direkt von GitHub in das Verzeichnis /usr/local/bin/ herunter:

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

Erklärung: $(uname -s) und $(uname -m) ermitteln automatisch Ihr Betriebssystem (Linux) und Ihre Prozessorarchitektur (z. B. x86_64).

Schritt 2: Ausführungsrechte vergeben

Machen Sie die heruntergeladene Datei ausführbar:

sudo chmod +x /usr/local/bin/docker-compose

Schritt 3: Installation überprüfen

Prüfen Sie, ob der Befehl systemweit funktioniert:

docker-compose --version

Beispielausgabe:

Docker Compose version v2.x.x

Funktionstest: Eine Test-Anwendung starten

Um sicherzustellen, dass Docker Compose einwandfrei funktioniert, können Sie einen kurzen Test mit einem Webserver (Nginx) durchführen.

  1. Erstellen Sie einen Testordner und wechseln Sie hinein:

    mkdir compose-test && cd compose-test

  2. Erstellen Sie eine Datei namens docker-compose.yml:

    nano docker-compose.yml

  3. Fügen Sie folgenden Inhalt ein:

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

    (Speichern und schließen Sie die Datei mit STRG+O, Enter und STRG+X).

  4. Starten Sie den Container im Hintergrund:

    • Bei Methode 1:
      docker compose up -d
    • Bei Methode 2:
      docker-compose up -d

  5. Testen: Öffnen Sie Ihren Browser und rufen Sie http://Ihre-Server-IP:8080 (oder http://localhost:8080) auf. Sie sollten die Standard-Willkommensseite von Nginx sehen.

  6. Aufräumen: Stoppen und entfernen Sie den Test-Container wieder:

    docker compose down
# bzw.
docker-compose down

Zusammenfassung

Docker Compose ist nun einsatzbereit auf Ihrem Ubuntu-System. Sie können ab sofort komplexe Container-Stacks (wie WordPress mit MySQL, Nextcloud oder eigene Microservices) mit einfachen Konfigurationsdateien per Knopfdruck starten und stoppen.

0