v0 Center-Website auf Recast (Docker)
Ziel: v0-Projekte wie gewohnt bauen — aber statt Vercel auf dem Recast-Root-Server hosten, mit Auto-Deploy über GitHub → GHCR → Docker.
Der Multi-Tenant-Weg (Dockerfile.center-website, eine App für viele Domains) bleibt im Repo erhalten. Dieser Guide gilt für ein GitHub-Repo pro v0-Center.
Was gleich bleibt
- v0 bauen mit Cockpit-Instructions (A–J)
- Cockpit-API, Register-Token, Revalidate-Route
- Redaktion arbeitet in v0 — kein Server-Zugriff nötig
Was anders ist
| Vercel | Recast | |
|---|---|---|
| Hosting | Vercel-Projekt | Docker auf Root-Server |
| Deploy | Vercel Auto-Build | GitHub Action → GHCR → docker compose pull |
| Register | postbuild + VERCEL_URL | COCKPIT_DEPLOY_ORIGIN + Start-Skript |
Deploy-Paket (einmalig pro Center-Repo kopieren)
Im Monorepo: deployment-templates/v0-recast/
Enthält u. a.:
Dockerfile(standalone Next.js)docker-compose.yml(für Recast-Server)docker/scripts/(Register + Entrypoint)github-workflows/build-push-ghcr.yml.example.env.example
Ausführliche Schritte: README in diesem Ordner.
Kurz-Checkliste
Cockpit / v0 (wie bisher)
- Center anlegen, Slug notieren
- v0-Projekt aus Team-Template (Register + Revalidate Routes)
- Register-Token erzeugen (Frontend-Kanäle)
Einmalig Deploy-Setup
- Dateien aus
deployment-templates/v0-recast/ins Center-GitHub-Repo kopieren next.config:output: 'standalone'- GitHub Action aktivieren → Image in GHCR
- Recast: Verzeichnis
/srv/docker/centers/<slug>/, Compose +.env, Nginx, SSL - Container starten → Cockpit-Register prüfen
Alltag
v0 ändern → GitHub push → GHCR → Recast pull → live
Revalidierung
Nach Register steht websitePublicUrl im Cockpit. Das Dashboard revalidiert diese URL im root-Pfadmodus — kein manueller Eintrag in CENTER_WEBSITE_URLS nötig.
REVALIDATION_SECRET muss in der Server-.env und im Cockpit-Dashboard identisch sein.
Siehe auch
- Go-Live: DNS — Abschnitt MEC auf Recast — DNS A-Record,
by-domain, Abgrenzung Vercel Go-Live - v0 Team-Template einrichten — Abschnitt Recast
- SETUP-NOTES-for-hoster.md — Server-Anforderungen
- Multi-Tenant Docker:
Dockerfile.center-websiteim Repo-Root
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /developer-guide/v0-recast-deploy