Ich wollte auf meinem MacBook und auf dem VPS dieselbe Container-Runtime: dieselben Befehle, dieselbe Compose-Datei, dasselbe Bild im Kopf. Podman statt Docker habe ich vor allem genommen, weil es standardmäßig rootless läuft und unter Linux keinen Daemon braucht. Auf einem kleinen VPS kostet jeder Hintergrundprozess etwas.
Das Setup
- Lokal: macOS mit Homebrew, Podman läuft in seiner verwalteten VM.
- Server: Debian- oder Ubuntu-VPS, Podman aus den Paketen der Distribution.
- Compose:
podman-composeauf beiden Seiten, ganz ohne Docker.
Lokal installieren (macOS)
brew update
brew install podman podman-compose
Podman läuft auf macOS in einer kleinen Linux-VM. Die wird angelegt und gestartet:
podman machine init
podman machine start
Kurz prüfen, ob der Client die VM erreicht:
podman --version
podman info
podman system connection list
Stolperstein: Homebrew installiert sowohl podman compose (den Unterbefehl) als auch podman-compose (ein eigenes Python-Projekt). Der Unterbefehl ruft ohne Weiteres docker-compose auf, wenn es im PATH liegt, und dann ist der Sinn dahin. Leg den Provider deshalb fest:
export PODMAN_COMPOSE_PROVIDER=/opt/homebrew/bin/podman-compose
echo 'export PODMAN_COMPOSE_PROVIDER=/opt/homebrew/bin/podman-compose' >> ~/.zshrc
source ~/.zshrc
Auf dem Server installieren (Debian/Ubuntu)
sudo apt-get update
sudo apt-get -y install podman podman-compose git
Dieselbe Prüfung wie auf macOS:
podman --version
podman info
podman system connection list
Bei mehreren Containern in einem Compose-Setup sollten sich die Dienste über ihren Namen finden, ohne Zusatzarbeit. Die Standardinstallation bringt die Netzwerk-Plugins dafür nicht immer mit. Installiere netavark und aardvark-dns, die Netzwerk- und DNS-Schicht von Podman:
sudo apt-get -y install netavark aardvark-dns
Jetzt lösen sich die Compose-Dienste im Podman-Netzwerk gegenseitig über ihren Namen auf, ohne dass du IPs von Hand verdrahten musst.
Der erste Test (auf beiden Seiten)
Ein echtes Image ziehen und einen Wegwerf-Container starten ist der günstigste Weg, Runtime und Registry gleichzeitig zu prüfen:
podman pull docker.io/library/node:20-bookworm-slim
podman run --rm docker.io/library/node:20-bookworm-slim node --version
Steht eine Node-Version auf stdout, funktioniert die ganze Kette: Runtime, Image-Auflösung, Registry-Zugriff, Ausführung im Container.
Typische Probleme bei der ersten Installation
connection refusedam Podman-Socket (macOS). Die VM läuft nicht oder hängt.podman machine stop && podman machine starthilft fast immer.invalid username/passwordbeim Ziehen öffentlicher Images. Alte Anmeldedaten in~/.config/containers/auth.json. Oft reicht ein einfachespodman pull, ganz ohne neues Login.podman composenimmt den falschen Provider.PODMAN_COMPOSE_PROVIDERfest setzen, statt sich auf die automatische Erkennung zu verlassen.
Die Befehle für jeden Tag
Diese drei Befehle brauche ich in neunzig Prozent der Fälle, auf dem Laptop genauso wie auf dem Server:
podman compose -f compose.yml up --build -d
podman compose -f compose.yml logs -f
podman compose -f compose.yml down
Zum Mitnehmen
- Lokale Installation und Server gleich zu halten zahlt sich bei jedem Deploy aus: Du musst nichts im Kopf übersetzen.
- Rootless ist die Voreinstellung, und für einen kleinen VPS mit einem einzigen Dienst ist sie die richtige.
- Damit der Compose-Stack nach einem Neustart wiederkommt, braucht er eine systemd-Unit. Die Restart-Policy allein reicht nicht.
Mehr dazu
- Thema
-
- Self-Hosting Dienste auf einem Server betreiben, über den du selbst verfügst, statt die gehostete Fassung eines Anbieters zu nutzen.
- Grundlage für
-
- Einen Compose-Stack nach einem Neustart weiterlaufen lassen Eine systemd-Unit, die einen Podman-Compose-Stack beim Booten startet, damit die Website nach einem Neustart des VPS von selbst wiederkommt.
- Nutzt
-
- Podman Container-Engine ohne Hintergrunddienst, unter Linux standardmäßig rootless, mit denselben Befehlen auf dem Mac und auf dem Server.
- Schlagwörter