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.
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 pslistet laufende Container auf.docker compose logs -fverfolgt die Logs.docker compose pull && docker compose up -daktualisiert auf neuere Images.docker system pruneentfernt ungenutzte Images und gestoppte Container.
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 -tlnpund wählen Sie einen anderen Port. - Kein Speicher mehr. Führen Sie
docker system dfaus und entfernen Sie ungenutzte Daten mitdocker 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.