No KYC VPS
Anleitungen12 Okt. 20267 Min. LesezeitVon dem No KYC VPS-Team

So installieren Sie Docker und Docker Compose auf einem Ubuntu-VPS

Docker Engine aus dem offiziellen Repository installieren, ohne sudo ausführen, einen ersten Compose-Dienst starten und die Firewall-Falle vermeiden, die Ports offenlegt.

Mit Docker betreiben Sie Datenbanken, Web-Apps und Tools in isolierten Containern, sodass die Installation von etwas Neuem nie den Rest Ihres Servers durcheinanderbringt. Diese Anleitung installiert Docker Engine und Docker Compose unter Ubuntu und startet einen ersten echten Dienst.

Terminalfenster auf einem VPS mit den Befehlen zur Installation von Docker auf einem Ubuntu-VPS, beginnend mit „sudo apt update“
Die Art von Befehlen, die Sie in dieser Anleitung auf Ihrem Server ausführen.

1. Aus dem Docker-Repository installieren

sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo 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" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

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

Prüfen Sie die Installation mit sudo docker run hello-world.

2. Docker ohne sudo ausführen

sudo usermod -aG docker $USER
newgrp docker

Mitglieder der Gruppe docker haben auf dem Rechner faktisch Root-Rechte, fügen Sie deshalb nur Benutzer hinzu, denen Sie vertrauen.

3. Ihre erste Compose-Datei

Legen Sie einen Ordner und eine compose.yaml an, die das Monitoring-Tool Uptime Kuma ausführt:

mkdir -p ~/kuma && cd ~/kuma
cat > compose.yaml <<'EOF'
services:
  kuma:
    image: louislam/uptime-kuma:1
    restart: unless-stopped
    ports:
      - "127.0.0.1:3001:3001"
    volumes:
      - ./data:/app/data
EOF
docker compose up -d

Die Bindung an 127.0.0.1 hält den Port aus dem öffentlichen Internet heraus. Schalten Sie einen Reverse-Proxy wie Nginx oder Caddy davor, wenn Sie von außen darauf zugreifen möchten.

Alltägliche Befehle

  • docker ps listet laufende Container auf.
  • docker compose logs -f verfolgt die Logs.
  • docker compose pull && docker compose up -d aktualisiert auf neuere Images.
  • docker system prune entfernt ungenutzte Images und gestoppte Container.
The steps of this guide in order: 1. 1. Install from Docker's repository; 2. 2. Run Docker without sudo; 3. 3. Your first Compose file; 4. Everyday commands; 5. A security warning about firewalls; 6. What to run next
Die Schritte dieser Anleitung in der Reihenfolge.

Ein Sicherheitshinweis zu Firewalls

Docker schreibt eigene iptables-Regeln. Ein als "8080:80" veröffentlichter Port kann aus dem Internet erreichbar sein, selbst wenn UFW ihn als blockiert anzeigt. Veröffentlichen Sie nur, was öffentlich sein muss, binden Sie private Dienste an 127.0.0.1 und testen Sie von außen mit einem Portscanner.

Logs und Speicherplatz im Griff behalten

Container-Logs wachsen standardmäßig unbegrenzt. Begrenzen Sie sie in /etc/docker/daemon.json:

{
  "log-driver": "json-file",
  "log-opts": { "max-size": "10m", "max-file": "3" }
}

Starten Sie Docker mit sudo systemctl restart docker neu. Die Einstellung gilt für Container, die Sie danach anlegen. Den Speicherverbrauch prüfen Sie jederzeit mit docker system df.

Fehlerbehebung

  • Permission denied am Docker-Socket. Ihr Benutzer ist noch nicht in der Gruppe docker, oder Sie haben sich seit dem Hinzufügen nicht neu angemeldet.
  • Ein Container startet ständig neu. Lesen Sie seine Logs mit docker logs container-name. Meist liegt es an einer falschen Einstellung oder einer fehlenden Datei.
  • Port bereits belegt. Ein anderes Programm hält den Port. Finden Sie es mit sudo ss -tlnp und wählen Sie einen anderen Port.
  • Kein Speicher mehr. Führen Sie docker system df aus und entfernen Sie ungenutzte Daten mit docker system prune.

Start beim Booten sicherstellen

Unter Ubuntu ist der Dienst automatisch aktiviert. Prüfen Sie das mit systemctl is-enabled docker und aktivieren Sie ihn bei Bedarf mit sudo systemctl enable --now docker. Container mit restart: unless-stopped kommen dann nach einem Neustart zurück.

Was als Nächstes laufen kann

Beliebte selbst gehostete Apps sind Nextcloud, Vaultwarden, Gitea, Plausible, n8n und Jellyfin. Ein vollständiges Beispiel finden Sie in unserer Anleitung zum Selbsthosten von Nextcloud.

Häufig gestellte Fragen

Muss ich Docker Compose separat installieren?

Nein. Das oben installierte Paket docker-compose-plugin fügt den Befehl docker compose hinzu.

Ist es sicher, einen Benutzer zur Gruppe docker hinzuzufügen?

Nur bei vertrauenswürdigen Benutzern, denn Mitglieder der Gruppe können Root-Rechte auf der Maschine erlangen.

Wie aktualisiere ich einen Container?

Führen Sie im Ordner mit der Compose-Datei docker compose pull und danach docker compose up -d aus.