Voraussetzungen

Ring Platform ist eine Next.js 16 + React 19-App mit einem verpflichtenden DB_BACKEND_MODE. Lokale Klone und Klone mit Produktionsparität nutzen PostgreSQL als Primärdatenbank (k8s-postgres-fcm). Nur Firestore (firebase-full) ist ein schmalerer Prototyp-Weg.

Vergleich der Deploy-Ziele

Auf einen Blick

Empfohlener Weg

Folge dem Ablauf des Hubs Erste Schritte: diese Checkliste erfüllen → install.sh ausführen → Schema anwenden → Smoke-Test.

1. Prüfe Node 20+ und einen Plan für Postgres (Docker 16 oder Homebrew 18 + PostGIS).
2. Weiter mit der Installation (./install.sh --quick oder manuelles Env).
3. Wende die Datenbankmigrationen an, danach den Ersten Erfolg.

Manueller Weg

1. 1

   Konten und Ports erfassen

   Entscheide zwischen OSS-Self-Hosting und Verwaltung durch Ringdom. Gib 3000 und 5432 frei (oder setze DB_PORT / den App-PORT bewusst).

2. 2

   Postgres mit PostGIS bereitstellen

   Lege die Datenbank ring_platform / den Benutzer ring_user an (oder passe sie an deine DATABASE_URL an). Prüfe, dass CREATE EXTENSION postgis funktioniert, bevor du data/schema.sql anwendest.

3. 3

   Env anlegen, ohne Schlüssel zu erfinden

   Kopiere env.local.template → .env.local (oder überlasse das install.sh). Setze DB_BACKEND_MODE, erzeuge AUTH_SECRET / WALLET_ENCRYPTION_KEY und füge einen Auth-Weg hinzu. Füge keine Produktions-Secrets in Doku oder Git ein.

Häufige Fragen

Auswirkungen

Startet mein Klon ohne Google OAuth?

Ja, der Prozess startet: Zuerst zählen AUTH_SECRET + DB_BACKEND_MODE. Für die Anmeldung von Testern brauchst du trotzdem mindestens einen Anbieter: Google, Apple oder Ring Mailer (Ethereal/SMTP).

Brauche ich Firebase am ersten Tag?

Nicht für App-Daten mit Postgres als Primärdatenbank. Firebase Admin / NEXT_PUBLIC_FIREBASE_* sind wichtig, wenn du FCM-Push aktivierst oder firebase-full wählst.

Brauche ich Redis?

Nein, nicht für ein lokales npm run dev mit einer einzigen Replik. Setze REDIS_URL, wenn Rate-Limit / set-nx über mehrere Prozesse geteilt werden sollen.

Betrieb

Wird Node 18 noch unterstützt?

Nein. install.sh verlangt Node 20+. Laut den Fehlerbehebungsbeispielen in INSTALL.md ist Node 22+ vorzuziehen.

PostGIS ist bei schema.sql fehlgeschlagen?

Installiere PostGIS für dein Postgres (Homebrew postgis oder ein Image mit PostGIS). Das zusammengeführte Schema 4.1.0 aktiviert die Erweiterung bei einer frischen Anwendung.

/api/health ist nicht healthy?

Prüfe, ob .env.local ein AUTH_SECRET enthält. Auf den Postgres-Erkennungspfaden behandelt die Health-Route dieses Secret als kritisch. Fehlende Firebase-Variablen spielen eher bei Setups ohne Postgres eine Rolle.

Verwaltetes Hosting: Kann ich diese Seite überspringen?

Für den ersten Start größtenteils ja. Behalte sie als Vertrag für später, wenn du eigenes OAuth, Zahlungen oder einen Fork von Layer1 anbindest.

Verwandte Dokumentation

Voraussetzungen

Ring Platform ist eine Next.js 16 + React 19-App mit einem verpflichtenden DB_BACKEND_MODE. Lokale Klone und Klone mit Produktionsparität nutzen PostgreSQL als Primärdatenbank (k8s-postgres-fcm). Nur Firestore (firebase-full) ist ein schmalerer Prototyp-Weg.

Vergleich der Deploy-Ziele

Auf einen Blick

Empfohlener Weg

Folge dem Ablauf des Hubs Erste Schritte: diese Checkliste erfüllen → install.sh ausführen → Schema anwenden → Smoke-Test.

1. Prüfe Node 20+ und einen Plan für Postgres (Docker 16 oder Homebrew 18 + PostGIS).
2. Weiter mit der Installation (./install.sh --quick oder manuelles Env).
3. Wende die Datenbankmigrationen an, danach den Ersten Erfolg.

Manueller Weg

1. 1

   Konten und Ports erfassen

   Entscheide zwischen OSS-Self-Hosting und Verwaltung durch Ringdom. Gib 3000 und 5432 frei (oder setze DB_PORT / den App-PORT bewusst).

2. 2

   Postgres mit PostGIS bereitstellen

   Lege die Datenbank ring_platform / den Benutzer ring_user an (oder passe sie an deine DATABASE_URL an). Prüfe, dass CREATE EXTENSION postgis funktioniert, bevor du data/schema.sql anwendest.

3. 3

   Env anlegen, ohne Schlüssel zu erfinden

   Kopiere env.local.template → .env.local (oder überlasse das install.sh). Setze DB_BACKEND_MODE, erzeuge AUTH_SECRET / WALLET_ENCRYPTION_KEY und füge einen Auth-Weg hinzu. Füge keine Produktions-Secrets in Doku oder Git ein.

Häufige Fragen

Auswirkungen

Startet mein Klon ohne Google OAuth?

Ja, der Prozess startet: Zuerst zählen AUTH_SECRET + DB_BACKEND_MODE. Für die Anmeldung von Testern brauchst du trotzdem mindestens einen Anbieter: Google, Apple oder Ring Mailer (Ethereal/SMTP).

Brauche ich Firebase am ersten Tag?

Nicht für App-Daten mit Postgres als Primärdatenbank. Firebase Admin / NEXT_PUBLIC_FIREBASE_* sind wichtig, wenn du FCM-Push aktivierst oder firebase-full wählst.

Brauche ich Redis?

Nein, nicht für ein lokales npm run dev mit einer einzigen Replik. Setze REDIS_URL, wenn Rate-Limit / set-nx über mehrere Prozesse geteilt werden sollen.

Betrieb

Wird Node 18 noch unterstützt?

Nein. install.sh verlangt Node 20+. Laut den Fehlerbehebungsbeispielen in INSTALL.md ist Node 22+ vorzuziehen.

PostGIS ist bei schema.sql fehlgeschlagen?

Installiere PostGIS für dein Postgres (Homebrew postgis oder ein Image mit PostGIS). Das zusammengeführte Schema 4.1.0 aktiviert die Erweiterung bei einer frischen Anwendung.

/api/health ist nicht healthy?

Prüfe, ob .env.local ein AUTH_SECRET enthält. Auf den Postgres-Erkennungspfaden behandelt die Health-Route dieses Secret als kritisch. Fehlende Firebase-Variablen spielen eher bei Setups ohne Postgres eine Rolle.

Verwaltetes Hosting: Kann ich diese Seite überspringen?

Für den ersten Start größtenteils ja. Behalte sie als Vertrag für später, wenn du eigenes OAuth, Zahlungen oder einen Fork von Layer1 anbindest.

Verwandte Dokumentation

Voraussetzungen

Ring Platform ist eine Next.js 16 + React 19-App mit einem verpflichtenden DB_BACKEND_MODE. Lokale Klone und Klone mit Produktionsparität nutzen PostgreSQL als Primärdatenbank (k8s-postgres-fcm). Nur Firestore (firebase-full) ist ein schmalerer Prototyp-Weg.

Vergleich der Deploy-Ziele

Auf einen Blick

Empfohlener Weg

Folge dem Ablauf des Hubs Erste Schritte: diese Checkliste erfüllen → install.sh ausführen → Schema anwenden → Smoke-Test.

1. Prüfe Node 20+ und einen Plan für Postgres (Docker 16 oder Homebrew 18 + PostGIS).
2. Weiter mit der Installation (./install.sh --quick oder manuelles Env).
3. Wende die Datenbankmigrationen an, danach den Ersten Erfolg.

Manueller Weg

1. 1

   Konten und Ports erfassen

   Entscheide zwischen OSS-Self-Hosting und Verwaltung durch Ringdom. Gib 3000 und 5432 frei (oder setze DB_PORT / den App-PORT bewusst).

2. 2

   Postgres mit PostGIS bereitstellen

   Lege die Datenbank ring_platform / den Benutzer ring_user an (oder passe sie an deine DATABASE_URL an). Prüfe, dass CREATE EXTENSION postgis funktioniert, bevor du data/schema.sql anwendest.

3. 3

   Env anlegen, ohne Schlüssel zu erfinden

   Kopiere env.local.template → .env.local (oder überlasse das install.sh). Setze DB_BACKEND_MODE, erzeuge AUTH_SECRET / WALLET_ENCRYPTION_KEY und füge einen Auth-Weg hinzu. Füge keine Produktions-Secrets in Doku oder Git ein.

Häufige Fragen

Auswirkungen

Startet mein Klon ohne Google OAuth?

Ja, der Prozess startet: Zuerst zählen AUTH_SECRET + DB_BACKEND_MODE. Für die Anmeldung von Testern brauchst du trotzdem mindestens einen Anbieter: Google, Apple oder Ring Mailer (Ethereal/SMTP).

Brauche ich Firebase am ersten Tag?

Nicht für App-Daten mit Postgres als Primärdatenbank. Firebase Admin / NEXT_PUBLIC_FIREBASE_* sind wichtig, wenn du FCM-Push aktivierst oder firebase-full wählst.

Brauche ich Redis?

Nein, nicht für ein lokales npm run dev mit einer einzigen Replik. Setze REDIS_URL, wenn Rate-Limit / set-nx über mehrere Prozesse geteilt werden sollen.

Betrieb

Wird Node 18 noch unterstützt?

Nein. install.sh verlangt Node 20+. Laut den Fehlerbehebungsbeispielen in INSTALL.md ist Node 22+ vorzuziehen.

PostGIS ist bei schema.sql fehlgeschlagen?

Installiere PostGIS für dein Postgres (Homebrew postgis oder ein Image mit PostGIS). Das zusammengeführte Schema 4.1.0 aktiviert die Erweiterung bei einer frischen Anwendung.

/api/health ist nicht healthy?

Prüfe, ob .env.local ein AUTH_SECRET enthält. Auf den Postgres-Erkennungspfaden behandelt die Health-Route dieses Secret als kritisch. Fehlende Firebase-Variablen spielen eher bei Setups ohne Postgres eine Rolle.

Verwaltetes Hosting: Kann ich diese Seite überspringen?

Für den ersten Start größtenteils ja. Behalte sie als Vertrag für später, wenn du eigenes OAuth, Zahlungen oder einen Fork von Layer1 anbindest.

Verwandte Dokumentation

Mindestens ein Auth.js-Weg: Google OAuth, Apple oder Ring Mailer (SMTP_* oder EMAIL_MODE=ethereal).

Checkliste der Konten (Gründer)

Ehrliches Zeitbudget (ungefähr)

Die Zeiten hängen vom Rechner und von der Einrichtung der Zugangsdaten ab. Betrachte sie als Planungsrahmen, nicht als SLA.

DATABASE_MODE wurde entfernt: nicht setzen. Im Detail: Backend-Modi.

Minimale Umgebungsvariablen

In auth.ts registrierte Anbieter: Credentials von Ring Mailer (email-otp, email-magic, credentials), Google OAuth, Google One Tap, Apple sowie Wallet-/Krypto-Credentials. GitHub-/Discord-OAuth sind nicht in der Standardliste der Anbieter. Resend / AUTH_RESEND_KEY gehören nicht zur Mailer-Referenz (nutze SMTP_* / Ethereal).

Optional für spätere Funktionen:

• BLOB_READ_WRITE_TOKEN: Uploads zu Vercel Blob
• WAYFORPAY_* / STRIPE_*: PaymentConductor
• NEXT_PUBLIC_FIREBASE_* + Admin-Dienstkonto: FCM-Push (nicht die Firestore-Datenbank bei Postgres als Primärdatenbank)
• OPENAI_API_KEY / ANTHROPIC_API_KEY: AI Matcher / Email CRM
• REDIS_URL: optional; ohne Wert gilt der Fallback im Prozessspeicher

Committe .env.local niemals. Siehe Umgebungskonfiguration.

Validierungs-Checkliste

1. 1

   System

2. 2

   Datenbank

3. 3

   Health (nach der Installation)

   Erwartet wird "healthy", wenn AUTH_SECRET gesetzt ist (app/api/health/route.ts behandelt ein fehlendes AUTH_SECRET als kritisch). Siehe Monitoring.

Optional: Docker-Compose-Stack

install.sh kann docker-compose.yml aus docker-compose.template.yml erzeugen (App + postgres:16-alpine + redis:7-alpine, dazu ein optionales Monitoring-Profil). Für das npm run dev am ersten Tag reicht ein einzelner Postgres-Container (oder Homebrew). Redis bleibt optional.

Gleicher Ablauf: DB_BACKEND_MODE vor dem ersten Start wählen.

Mindestens ein Auth.js-Weg: Google OAuth, Apple oder Ring Mailer (SMTP_* oder EMAIL_MODE=ethereal).

Checkliste der Konten (Gründer)

Ehrliches Zeitbudget (ungefähr)

Die Zeiten hängen vom Rechner und von der Einrichtung der Zugangsdaten ab. Betrachte sie als Planungsrahmen, nicht als SLA.

DATABASE_MODE wurde entfernt: nicht setzen. Im Detail: Backend-Modi.

Minimale Umgebungsvariablen

In auth.ts registrierte Anbieter: Credentials von Ring Mailer (email-otp, email-magic, credentials), Google OAuth, Google One Tap, Apple sowie Wallet-/Krypto-Credentials. GitHub-/Discord-OAuth sind nicht in der Standardliste der Anbieter. Resend / AUTH_RESEND_KEY gehören nicht zur Mailer-Referenz (nutze SMTP_* / Ethereal).

Optional für spätere Funktionen:

• BLOB_READ_WRITE_TOKEN: Uploads zu Vercel Blob
• WAYFORPAY_* / STRIPE_*: PaymentConductor
• NEXT_PUBLIC_FIREBASE_* + Admin-Dienstkonto: FCM-Push (nicht die Firestore-Datenbank bei Postgres als Primärdatenbank)
• OPENAI_API_KEY / ANTHROPIC_API_KEY: AI Matcher / Email CRM
• REDIS_URL: optional; ohne Wert gilt der Fallback im Prozessspeicher

Committe .env.local niemals. Siehe Umgebungskonfiguration.

Validierungs-Checkliste

1. 1

   System

2. 2

   Datenbank

3. 3

   Health (nach der Installation)

   Erwartet wird "healthy", wenn AUTH_SECRET gesetzt ist (app/api/health/route.ts behandelt ein fehlendes AUTH_SECRET als kritisch). Siehe Monitoring.

Optional: Docker-Compose-Stack

install.sh kann docker-compose.yml aus docker-compose.template.yml erzeugen (App + postgres:16-alpine + redis:7-alpine, dazu ein optionales Monitoring-Profil). Für das npm run dev am ersten Tag reicht ein einzelner Postgres-Container (oder Homebrew). Redis bleibt optional.

Gleicher Ablauf: DB_BACKEND_MODE vor dem ersten Start wählen.

Mindestens ein Auth.js-Weg: Google OAuth, Apple oder Ring Mailer (SMTP_* oder EMAIL_MODE=ethereal).

Checkliste der Konten (Gründer)

Ehrliches Zeitbudget (ungefähr)

Die Zeiten hängen vom Rechner und von der Einrichtung der Zugangsdaten ab. Betrachte sie als Planungsrahmen, nicht als SLA.

DATABASE_MODE wurde entfernt: nicht setzen. Im Detail: Backend-Modi.

Minimale Umgebungsvariablen

In auth.ts registrierte Anbieter: Credentials von Ring Mailer (email-otp, email-magic, credentials), Google OAuth, Google One Tap, Apple sowie Wallet-/Krypto-Credentials. GitHub-/Discord-OAuth sind nicht in der Standardliste der Anbieter. Resend / AUTH_RESEND_KEY gehören nicht zur Mailer-Referenz (nutze SMTP_* / Ethereal).

Optional für spätere Funktionen:

• BLOB_READ_WRITE_TOKEN: Uploads zu Vercel Blob
• WAYFORPAY_* / STRIPE_*: PaymentConductor
• NEXT_PUBLIC_FIREBASE_* + Admin-Dienstkonto: FCM-Push (nicht die Firestore-Datenbank bei Postgres als Primärdatenbank)
• OPENAI_API_KEY / ANTHROPIC_API_KEY: AI Matcher / Email CRM
• REDIS_URL: optional; ohne Wert gilt der Fallback im Prozessspeicher

Committe .env.local niemals. Siehe Umgebungskonfiguration.

Validierungs-Checkliste

1. 1

   System

2. 2

   Datenbank

3. 3

   Health (nach der Installation)

   Erwartet wird "healthy", wenn AUTH_SECRET gesetzt ist (app/api/health/route.ts behandelt ein fehlendes AUTH_SECRET als kritisch). Siehe Monitoring.

Optional: Docker-Compose-Stack

install.sh kann docker-compose.yml aus docker-compose.template.yml erzeugen (App + postgres:16-alpine + redis:7-alpine, dazu ein optionales Monitoring-Profil). Für das npm run dev am ersten Tag reicht ein einzelner Postgres-Container (oder Homebrew). Redis bleibt optional.

Gleicher Ablauf: DB_BACKEND_MODE vor dem ersten Start wählen.