Podman lokal und auf einem VPS installieren

Podman mit podman-compose auf macOS und auf einem Debian- oder Ubuntu-Server, mit denselben Befehlen auf beiden Seiten und einem ersten Test.

Artikel Erstellt Aktualisiert Auch auf Englisch: Installing Podman Locally and on a VPS

Geprüft von adrian am

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-compose auf 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 refused am Podman-Socket (macOS). Die VM läuft nicht oder hängt. podman machine stop && podman machine start hilft fast immer.
  • invalid username/password beim Ziehen öffentlicher Images. Alte Anmeldedaten in ~/.config/containers/auth.json. Oft reicht ein einfaches podman pull, ganz ohne neues Login.
  • podman compose nimmt den falschen Provider. PODMAN_COMPOSE_PROVIDER fest 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.

Beruht auf

  • Installing Podman Locally and on a VPS (raw/2026/2026-03-04/installing-podman-locally-and-on-a-vps.md) [post]

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

Nutzt

  • Podman Container-Engine ohne Hintergrunddienst, unter Linux standardmäßig rootless, mit denselben Befehlen auf dem Mac und auf dem Server.

In der Graph-Ansicht zeigen