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.

Als der VPS das erste Mal für ein Kernel-Update neu gestartet hat, blieb die Website down, bis ich mich per SSH angemeldet und podman-compose up -d von Hand ausgeführt habe. So etwas nimmst du nur einmal hin. Ein Deployment, das den eigenen Container übersteht, aber nicht die Maschine darunter, ist kein richtiger Produktivbetrieb. Das hier ist die kleinste systemd-Verdrahtung, mit der ein Neustart kein Ereignis mehr ist.

Das Setup

  • VPS: Debian, Podman mit root-Rechten, der Compose-Stack unter /opt/website.
  • Reverse Proxy: Caddy vor dem App-Container.
  • Ziel: Nach sudo reboot ist alles von selbst wieder da: Container, Caddy, TLS.

Restart-Policy in Compose

In compose.yml:

restart: unless-stopped

Das ist nötig, reicht aber nicht. Es sagt Podman, den Container nach einem Absturz neu zu starten. Nach einem kompletten Neustart ruft aber niemand podman-compose up auf, und so weiß Podman gar nichts von diesem Compose-Stack. Eine systemd-Unit muss den Lebenszyklus des Stacks übernehmen.

Ein systemd-Service für den Compose-Stack

/etc/systemd/system/website-compose.service:

[Unit]
Description=Website Podman Compose Stack
After=network-online.target
Wants=network-online.target

[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/opt/website
ExecStart=/usr/bin/podman-compose -f compose.yml up -d
ExecStop=/usr/bin/podman-compose -f compose.yml down
TimeoutStartSec=0

[Install]
WantedBy=multi-user.target

Zwei Details zählen:

  • Type=oneshot mit RemainAfterExit=yes: podman-compose up -d kehrt direkt nach dem Start des Containers zurück, systemd sieht den Prozess also enden. RemainAfterExit sorgt dafür, dass die Unit danach trotzdem als „active“ gilt.
  • After=network-online.target: Ohne diese Zeile kann der Stack beim Kaltstart dem Netzwerk zuvorkommen und nichts ziehen oder auflösen. Solche Fehler wirken zufällig und sind später schwer zu finden.

Aktivieren und starten:

sudo systemctl daemon-reload
sudo systemctl enable website-compose.service
sudo systemctl start website-compose.service
sudo systemctl status website-compose.service --no-pager

Prüfen, ob Caddy beim Booten startet

Das Debian-Paket von Caddy aktiviert seine Unit von sich aus. Prüf es trotzdem, statt es anzunehmen:

sudo systemctl enable caddy
sudo systemctl status caddy --no-pager

Der Neustart-Test

Ob die Verdrahtung stimmt, zeigt nur ein echter Neustart der Maschine:

sudo reboot

Nach dem erneuten Anmelden per SSH:

systemctl status website-compose.service --no-pager
podman ps
curl -I http://127.0.0.1:4321
curl -I https://adrian-altner.de

Was ich erwarte:

  • website-compose.service ist aktiv.
  • Der Website-Container läuft.
  • Die lokale und die öffentliche Prüfung liefern beide 200.

Fehlersuche nach einem Neustart

  • Container läuft nicht. Zuerst die Logs, immer: journalctl -u website-compose.service -n 100 --no-pager
  • Caddy läuft, die Website nicht. Meist liegt es am App-Container: podman logs --tail=200 website
  • Probleme mit TLS oder Proxy. Das Journal von Caddy sagt, welcher Hostname gescheitert ist und warum: journalctl -u caddy -n 100 --no-pager

Zum Mitnehmen

  • restart: unless-stopped deckt Abstürze ab, systemd deckt Neustarts ab. Du brauchst beides.
  • Starte die Maschine einmal absichtlich neu, bevor du dich unbeaufsichtigt auf das Setup verlassen musst.

Mehr dazu

Thema
  • Self-Hosting Dienste auf einem Server betreiben, über den du selbst verfügst, statt die gehostete Fassung eines Anbieters zu nutzen.
Baut auf
Nutzt
  • Caddy Webserver und Reverse Proxy, der TLS-Zertifikate selbst holt und erneuert, eingerichtet in einem kurzen Caddyfile.
  • Podman Container-Engine ohne Hintergrunddienst, unter Linux standardmäßig rootless, mit denselben Befehlen auf dem Mac und auf dem Server.
Im Text erwähnt
Schlagwörter

In der Graph-Ansicht zeigen →