Docker auf Proxmox: Anleitung für VM und LXC-Container

Proxmox VE verwaltet virtuelle Maschinen und LXC-Container, Docker gehört nicht dazu. Du hast drei Wege, Docker-Container trotzdem zu betreiben: in einer VM, in einem LXC-Container oder seit Proxmox VE 9.1 als OCI-Container direkt in Proxmox. Die Proxmox-Dokumentation empfiehlt für Anwendungscontainer wie Docker-Images ausdrücklich eine QEMU-VM. Diese Anleitung zeigt den Weg über eine Debian-VM und danach die Variante im LXC-Container. Sie bezieht sich auf Proxmox VE 9.2, Stand November 2026.

Die drei Wege im Vergleich

	VM mit Docker	LXC mit Docker	OCI-Container in Proxmox
Empfehlung von Proxmox	ja	nein	Technologievorschau
Eigener Kernel	ja	nein, teilt den Kernel des Hosts	nein
RAM-Bedarf	höher	gering	gering
Docker Compose	ja	ja	nein
Live-Migration im Cluster	ja	nein	nein
Risiko bei Proxmox-Updates	gering	höher	noch unklar

Docker in einer VM verhält sich wie auf einem eigenen Rechner. Die VM hat ihren eigenen Kernel, Updates von Proxmox oder des Container-Systems LXC berühren sie nicht. Der Preis ist etwas mehr RAM, weil Debian in der VM selbst Speicher belegt.

Im LXC-Container teilt Docker den Kernel mit dem Proxmox-Host. Das spart Speicher, macht die Kombination aber empfindlich. Ende 2025 funktionierte Docker in LXC-Containern nach einem Proxmox-Update zeitweise nicht mehr, der Fehler steht als Bug 7006 im Bugtracker von Proxmox.

Seit Version 9.1 kann Proxmox OCI-Images, also das Format von Docker-Images, als Vorlage für Container nutzen. Proxmox bezeichnet die Anwendungscontainer selbst als Technologievorschau. Laut Dokumentation werden dabei alle Schichten des Images zu einem Dateisystem zusammengefasst, ein Update durch Austauschen gegen ein neueres Image ist deshalb noch nicht möglich. Für Docker Compose taugt dieser Weg nicht.

Für die meisten Homeserver ist die VM die richtige Wahl. Mit 16 GB RAM im Mini-PC bleiben neben einer Docker-VM mit 4 GB genug Reserven für Home Assistant und weitere Gäste.

Beelink EQ14 (N150, 16 GB RAM, 2 × 2,5 Gbit/s, Proxmox-tauglich) bei Amazon ansehen

Docker in einer VM: was du brauchst

Proxmox VE 9, eingerichtet nach der Anleitung Proxmox installieren.
Das Netinstall-ISO von Debian 13 „Trixie“ von debian.org. Docker unterstützt Debian 13 laut eigener Dokumentation.
Für die VM 2 Kerne, 4 GB RAM und 32 GB Platte als Startwert. Mehr Platz brauchst du, wenn Container große Datenmengen speichern.

Schritt 1: Debian-ISO in Proxmox laden

Wähle links den Speicher local und dort „ISO Images“. Mit „Download from URL“ trägst du den Link zum Debian-ISO ein, Proxmox lädt die Datei dann direkt herunter. Alternativ lädst du das ISO auf deinen PC und überträgst es mit „Upload“.

Schritt 2: VM anlegen

Klicke auf „Create VM“ und gehe die Reiter durch:

Im Reiter „General“ vergibst du einen Namen, z. B. docker, und merkst dir die VM-ID.
Im Reiter „OS“ wählst du das Debian-ISO.
Im Reiter „System“ setzt du den Haken bei „Qemu Agent“. Damit zeigt Proxmox später die IP-Adresse der VM an und kann sie sauber herunterfahren.
Im Reiter „Disks“ stellst du 32 GB ein. Liegt die VM auf einer SSD, aktiviere „Discard“, damit freigegebener Platz an die SSD zurückgemeldet wird.
Im Reiter „CPU“ trägst du 2 Kerne ein, als „Type“ eignet sich host.
Im Reiter „Memory“ gibst du 4096 MB an.
Im Reiter „Network“ bleiben Bridge vmbr0 und Model „VirtIO“.

Mit „Finish“ anlegen, dann starten und die „Console“ öffnen.

Schritt 3: Debian installieren

Der Debian-Installer fragt Sprache, Netzwerk, Benutzer und Partitionierung ab. Für eine Docker-VM reicht die geführte Partitionierung mit allen Dateien auf einer Partition. Bei der Softwareauswahl nimmst du die Haken bei der Desktop-Umgebung heraus und wählst nur „SSH server“ und „Standard-Systemwerkzeuge“. Nach dem Neustart meldest du dich an und installierst den Gastagenten für Proxmox:

su -
apt update
apt install qemu-guest-agent sudo
usermod -aG sudo deinbenutzer

deinbenutzer ersetzt du durch den Benutzernamen aus der Installation. Nach einem Neustart der VM zeigt Proxmox unter „Summary“ die IP-Adresse, und du kannst dich per SSH verbinden.

Schritt 4: Docker installieren

Docker beschreibt als ersten Weg die Installation aus dem eigenen apt-Repository, darüber kommen Updates mit den normalen Systemupdates. Zuerst den Schlüssel und das Repository eintragen:

sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

Danach Docker mit dem Compose-Plugin installieren:

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

Ein Testcontainer zeigt, ob alles läuft:

sudo docker run hello-world

Damit dein Benutzer Docker ohne sudo bedienen darf, fügst du ihn der Gruppe docker hinzu und meldest dich neu an:

sudo usermod -aG docker $USER

Beachte: Mitglieder dieser Gruppe haben faktisch Root-Rechte auf der VM. Für eine VM, die nur Docker betreibt, ist das in Ordnung.

Docker bietet auch ein Installationsskript unter get.docker.com an. Laut Docker ist es für Test- und Entwicklungsumgebungen gedacht, für einen Server bleibst du beim Repository.

Schritt 5: Den ersten Dienst mit Docker Compose starten

Lege für jeden Dienst einen eigenen Ordner mit einer Datei compose.yaml an. Ein einfaches Beispiel mit dem Webserver nginx:

services:
  web:
    image: nginx:stable
    ports:
      - "8080:80"
    restart: unless-stopped

Gestartet wird im selben Ordner mit:

docker compose up -d

Danach erreichst du die Testseite unter http://IP-der-VM:8080. Nach demselben Muster richtest du z. B. Jellyfin, Paperless-ngx oder Immich ein. Welcher Medienserver passt, steht im Vergleich Jellyfin vs. Plex.

Alternative: Docker in einem LXC-Container

Wenn RAM knapp ist, kannst du Docker in einem LXC-Container betreiben. Rechne damit, dass ein Proxmox-Update die Kombination stören kann, und halte Backups des Containers bereit.

Unter local und „CT Templates“ mit „Templates“ die Vorlage für Debian 13 herunterladen.
Mit „Create CT“ einen Container anlegen. Den Haken bei „Unprivileged container“ lassen. Privilegierte Container stuft die Proxmox-Dokumentation als unsicher ein.
Nach dem Anlegen unter „Options“ und „Features“ die Optionen „nesting“ und „keyctl“ aktivieren. In der Shell des Proxmox-Hosts geht das auch so, 101 ist die Container-ID:

pct set 101 --features nesting=1,keyctl=1

Den Container starten und Docker wie in Schritt 4 installieren. Im Container bist du bereits root, sudo entfällt.

Backups

Proxmox sichert VMs und Container unter „Datacenter“ und „Backup“ nach Zeitplan. Das Backup enthält die ganze VM mit allen Docker-Volumes. Lege die Daten deiner Container trotzdem in klar benannten Ordnern ab, z. B. unter /opt/stacks/<dienst>, dann kannst du einzelne Dienste auch ohne Komplett-Restore umziehen.

Häufige Fragen

Kann ich Docker direkt auf dem Proxmox-Host installieren?

Technisch ja, Proxmox ist ein Debian-System. Proxmox empfiehlt für Anwendungscontainer aber eine VM. Docker verändert Netzwerk- und Firewall-Regeln des Systems, auf dem es läuft, was sich mit der Netzwerkverwaltung von Proxmox in die Quere kommen kann.

Wie viel RAM braucht eine Docker-VM?

Debian ohne Desktop kommt mit wenigen hundert MB aus. Der Rest hängt von den Containern ab. 4 GB sind ein guter Start für eine Handvoll Dienste, Immich oder Paperless-ngx mit Texterkennung brauchen mehr.

Brauche ich Portainer?

Nein. Portainer ist eine Weboberfläche für Docker und praktisch, wenn du Container lieber per Mausklick verwaltest. Alles in dieser Anleitung funktioniert auch ohne.

Läuft Home Assistant besser in Docker oder als eigene VM?

Als eigene VM mit Home Assistant OS. Nur dort gibt es Add-ons und Updates per Mausklick. Die Anleitung dazu steht unter Home Assistant auf Proxmox.