Start / Notizen

DevOps · CI/CD · Next.js

CI/CD für Next.js 15 auf dem VPS: GitHub Actions, PM2-Reload und Caddy

Manuelle Deployments waren langsam und fehleranfällig. Heute reicht ein git push – ohne Ausfallzeit und ohne PaaS.

Serge Zabolotny · 18.10.2026

• GitHub Actions
• CI/CD
• Next.js 15
• PM2
• Caddy
• pnpm
• VPS

Ausgangslage

PflegeOasis läuft auf einem eigenen VPS (Next.js 15, PostgreSQL 16, Drizzle ORM). Anfangs habe ich per SSH eingeloggt und die Schritte von Hand ausgeführt. Das kostet Zeit, und jeder vergessene Schritt ist eine mögliche Fehlerquelle.

Der Ablauf

1. Push auf den Hauptzweig löst einen GitHub-Actions-Workflow aus.
2. Der Workflow verbindet sich per SSH mit dem Server.
3. Auf dem Server laufen git pull, pnpm install und pnpm build.
4. pm2 reload startet die Next.js-App neu – ohne Ausfallzeit.
5. Caddy sitzt als Reverse Proxy davor und kümmert sich automatisch um TLS-Zertifikate.

Schematisch (vereinfacht) macht der Server beim Deployment Folgendes:

git pull
pnpm install
pnpm build
pm2 reload <app-name>

Warum kein PaaS?

• Kontrolle: Datenbank, Backups und Netzwerk liegen in meiner Hand, Hosting in Deutschland.
• Kosten: Ein VPS trägt mehrere Projekte, ohne dass Limits oder Cold Starts stören.
• Verständnis: Wer den Betrieb selbst baut, versteht, was bei einem Ausfall passiert.

Ergebnis

Deployment per git push: schneller, wiederholbar und ohne Handarbeit. Der Workflow ist die Dokumentation.

Weiterlesen