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 rebootist 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=oneshotmitRemainAfterExit=yes:podman-compose up -dkehrt direkt nach dem Start des Containers zurück, systemd sieht den Prozess also enden.RemainAfterExitsorgt 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.serviceist 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-stoppeddeckt 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
-
- 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.
- Nutzt
- Im Text erwähnt
-
- Caddy als Reverse Proxy mit HTTPS und kanonischem Host Caddy vor einem Container auf einem VPS: TLS von Let's Encrypt ohne Zutun, www leitet auf die Domain um, der Port der App ist von außen zu.
- Schlagwörter