Tutorials

Docker installieren

Mit Docker lassen sich Anwendungen in isolierten Containern betreiben — das macht Deployments reproduzierbar und einfach verwaltbar. Diese Anleitung behandelt die Installation von Docker Engine und Docker Compose auf Ubuntu und Debian.

Voraussetzungen

  • Ein VPS mit Ubuntu 20.04+ oder Debian 11+
  • Root- oder Sudo-Zugriff
  • Mindestens 1 GB RAM und 10 GB freier Speicherplatz

1. Mit deinem Server verbinden

ssh root@DEINE_SERVER_IP

Oder verwende das Web-Terminal im Sitequest-Dashboard.

2. Alte Versionen entfernen

Falls ältere Docker-Versionen installiert sind, entferne sie zuerst:

apt remove -y docker docker-engine docker.io containerd runc 2>/dev/null

3. Abhängigkeiten installieren

apt update
apt install -y ca-certificates curl gnupg

4. Offizielles Docker-Repository hinzufügen

install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  tee /etc/apt/sources.list.d/docker.list > /dev/null

Für Debian ersetze ubuntu durch debian in den obigen URLs.

5. Docker Engine installieren

apt update
apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

6. Installation prüfen

docker --version
docker compose version

Einen Testcontainer starten:

docker run --rm hello-world

Du solltest eine Bestätigung sehen, dass Docker korrekt läuft.

7. Docker beim Systemstart aktivieren

Docker ist auf den meisten Systemen bereits aktiviert. Prüfe den Status:

systemctl is-enabled docker

Falls die Ausgabe disabled ist, aktiviere Docker:

systemctl enable docker

8. (Optional) Docker als Nicht-Root-Benutzer ausführen

Standardmäßig erfordert Docker Root-Rechte. Um einem normalen Benutzer Zugriff zu geben:

usermod -aG docker DEIN_BENUTZERNAME

Melde dich danach ab und wieder an, damit die Änderung greift.

Erste Anwendung starten

Erstelle eine einfache docker-compose.yml zum Testen:

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

Starten:

docker compose up -d

Besuche http://DEINE_SERVER_IP im Browser, um die Nginx-Willkommensseite zu sehen. Stoppen mit:

docker compose down

Firewall-Hinweise

Wenn du eine Sitequest-Firewall konfiguriert hast, stelle sicher, dass die Ports deiner Container geöffnet sind. Docker pflegt seine eigenen iptables-Regeln, aber die Sitequest-Firewall greift auf Netzwerkebene, noch bevor der Traffic deinen Server erreicht.

Nächste Schritte