Skip to main content

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

VercelRecast
HostingVercel-ProjektDocker auf Root-Server
DeployVercel Auto-BuildGitHub Action → GHCR → docker compose pull
Registerpostbuild + VERCEL_URLCOCKPIT_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)

  1. Center anlegen, Slug notieren
  2. v0-Projekt aus Team-Template (Register + Revalidate Routes)
  3. Register-Token erzeugen (Frontend-Kanäle)

Einmalig Deploy-Setup

  1. Dateien aus deployment-templates/v0-recast/ ins Center-GitHub-Repo kopieren
  2. next.config: output: 'standalone'
  3. GitHub Action aktivieren → Image in GHCR
  4. Recast: Verzeichnis /srv/docker/centers/<slug>/, Compose + .env, Nginx, SSL
  5. 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

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/developer-guide/v0-recast-deploy