Setup-Anleitung

Von „frisch gekauft" bis „läuft auf eigener Domain" — in 30 bis 60 Minuten.

Die vollständige SETUP.md mit Troubleshooting, Backup-Strategien und Reverse-Proxy-Beispielen ist im Repo enthalten und wird dir nach dem Kauf zugänglich.

Voraussetzungen

Hardware

• Docker + Docker Compose v2
• Mindestens 4 GB RAM (8 GB empfohlen)
• ~5 GB Disk für Image + Cache

Accounts

• Supabase-Instanz (Cloud oder selbst-gehostet)
• Domain mit TLS (für Production)
• Optional: Google Cloud, OpenAI, Resend

Supabase aufsetzen

~15 Min

Nuvestra braucht eine Supabase-Instanz für Auth, Datenbank und Storage. Zwei Optionen:

Supabase Cloud (empfohlen für den Start) — Account auf supabase.com anlegen, neues Projekt in EU-Region erstellen (Frankfurt oder Irland für DSGVO).
Selbst-gehostet — offizielles Supabase Docker-Setup, mehr Aufwand aber 100 % auf deiner Hardware.

Danach: Project URL, anon key und service_role key aus Settings → API kopieren. Datenbank-Migrationen aus dem Repo via npx supabase db push einspielen.

Repo holen

~5 Min

Nach Lizenzkauf bekommst du per E-Mail Zugang zum privaten Git-Repo. Klonen:

git clone <dein-repo-url> nuvestra
cd nuvestra/deploy/self-host

.env konfigurieren

~10 Min

Template kopieren und Pflichtfelder ausfüllen:

cp .env.example .env

Mindestens setzen:

NEXT_PUBLIC_SUPABASE_URL — aus Schritt 1
NEXT_PUBLIC_SUPABASE_ANON_KEY — aus Schritt 1
SUPABASE_SERVICE_ROLE_KEY — aus Schritt 1, geheim halten
NEXT_PUBLIC_APP_URL — deine externe URL
CRON_SECRET — zufälliger String (openssl rand -hex 32)

KI-Provider (Vertex, OpenAI) und E-Mail (Resend) sind optional — kannst du leer lassen und später nachziehen.

Bauen und starten

~20 Min beim ersten Build

docker compose up -d --build

Beim ersten Mal lädt Docker das Node-Image, installiert ~1500 Packages und baut die App — etwa 20 Min. Folgende Builds sind viel schneller (Cache).

Verifizieren:

docker compose ps        # beide Container „Up"
docker compose logs -f   # Logs live

Erste Anmeldung

~5 Min

Browser öffnen auf http://localhost:3000 (oder deiner externen URL). Account anlegen über /auth → Registrieren.

Self-Host-Verifikation: rufe /dashboard/settings/subscription auf — du solltest die Self-Host-Karte sehen, NICHT die normale Subscription-Verwaltung.

Provider-Status auf /dashboard/settings/integrations — zeigt dir welche KI-/E-Mail-Provider du noch konfigurieren könntest.

Für Production: Reverse-Proxy

Push-Notifications und manche Browser-APIs setzen HTTPS voraus. Stell einen Reverse-Proxy (Caddy, Traefik, nginx) mit Let's-Encrypt-TLS vor die App. Caddy-Beispiel-Config + Troubleshooting findest du in der vollen SETUP.md im Repo.

Klingt machbar?

Lizenz kaufen, Repo-Zugang erhalten, Setup starten.