Preparing Ring content
Preparing Ring content
Preparing Ring content
Setze einen White-Label-Klon von Ring Platform auf deinem Rechner auf. Dieser Hub bildet den echten Entwicklungsablauf ab, der im Open-Source-Baum (connectplatform/ring) und auf ring-platform.org verwendet wird, dem Community-Portal für Self-Hosting-Enthusiasten.
| Weg | Zeit | Ergebnis |
|---|---|---|
./install.sh --quick + vorhandenes PostgreSQL | ~20–40 Min. | Klon-Konfiguration, Abhängigkeiten, Env-Gerüst. Schema und OAuth musst du noch selbst anwenden |
| Vollständiger Bootstrap mit Postgres als Primärdatenbank | 45–90 Min. | Lokaler Stack mit Produktionsparität (k8s-postgres-fcm) |
Prototyp (firebase-full) | ~15–30 Min. | Nur Firestore. Ohne die Tiefe von ERP, News Kingdom und PaymentConductor |
Willst du zuerst die Vision kennenlernen? Lies Willkommen bei Ring und komm dann hierher zurück.
Self-Hosting aus GitHub? Folge diesem Abschnitt. Schlüsselfertiges Hosting von Ringdom? Beginne auf ringdom.org. Nach der Übergabe nutzt du den Anpassungsleitfaden. Der öffentliche OSS-Baum enthält install.sh und Community-Skripte. Enterprise-Werkzeuge für k8s und CLI bleiben außerhalb der öffentlichen Grenze (FEATURESET.md).
| Ebene | Kanonisches Artefakt | Zweck |
|---|---|---|
| Klon-Identität | ring-config.json | Branding, Feature-Flags, Domains (ring-config.template.json) |
| Secrets und Backend | .env.local | DB_BACKEND_MODE, AUTH_*, Firebase FCM, Deploy-Ziel des Tunnels |
| Anwendungsdaten | PostgreSQL ring_platform | data/schema.sql v4.0.1+ und Kingdom-Migrationen |
| Authentifizierung | Auth.js v5 (auth.ts) | AUTH_SECRET und mindestens ein OAuth-Anbieter für die Anmeldung |
| Entwicklungs-Runtime | server.ts | : Next.js 16 + React 19 + natives WSS, wenn |
Interaktive Wege mit kopierbaren Installationsbefehlen: eigenes Deployment aus GitHub, von LegioX begleitete Anpassung oder Partnerschaft mit Promptor.
Produktion und lokale Entwicklung nutzen DB_BACKEND_MODE=k8s-postgres-fcm: PostgreSQL für die Anwendungsdaten, Firebase Admin nur für FCM-Push, wenn konfiguriert.
Überspringe den Installationsassistenten. Gleiches Ergebnis, mehr Kontrolle:
Im Detail: Installation.
Node.js 20+, Hardware, unterstützte Betriebssysteme, Firebase- und Google-Cloud-Konten
Vollständige Installationswege, Env-Referenz, Tunnel-Konfiguration, Tabelle häufiger Probleme
schema.sql v4.0.1+, Kingdom-Dateien 002–011, Datenbankmatrix der Klone
Smoke-Test für Authentifizierung, Entitäten, Opportunities und API-Health
Checkliste für den White-Label-Klon über den ersten Start hinaus
k8s-postgres-fcm oder supabase-fcm oder firebase-full
Projektstruktur, Tests, Postgres-Bootstrap mit Homebrew
BackendSelector, Adapter, FCM oder Firestore
install.sh: erster Bootstrap des Klons (Konfigurationsdateien + npm install). setup-dev.sh: Härtung der Umgebung nach dem Klonen und optionale Anbindung von Diensten. Nutze npm run setup:env für einen interaktiven, nicht destruktiven Durchgang über eine vorhandene .env.local.
Setze einen White-Label-Klon von Ring Platform auf deinem Rechner auf. Dieser Hub bildet den echten Entwicklungsablauf ab, der im Open-Source-Baum (connectplatform/ring) und auf ring-platform.org verwendet wird, dem Community-Portal für Self-Hosting-Enthusiasten.
| Weg | Zeit | Ergebnis |
|---|---|---|
./install.sh --quick + vorhandenes PostgreSQL | ~20–40 Min. | Klon-Konfiguration, Abhängigkeiten, Env-Gerüst. Schema und OAuth musst du noch selbst anwenden |
| Vollständiger Bootstrap mit Postgres als Primärdatenbank | 45–90 Min. | Lokaler Stack mit Produktionsparität (k8s-postgres-fcm) |
Prototyp (firebase-full) | ~15–30 Min. | Nur Firestore. Ohne die Tiefe von ERP, News Kingdom und PaymentConductor |
Willst du zuerst die Vision kennenlernen? Lies Willkommen bei Ring und komm dann hierher zurück.
Self-Hosting aus GitHub? Folge diesem Abschnitt. Schlüsselfertiges Hosting von Ringdom? Beginne auf ringdom.org. Nach der Übergabe nutzt du den Anpassungsleitfaden. Der öffentliche OSS-Baum enthält install.sh und Community-Skripte. Enterprise-Werkzeuge für k8s und CLI bleiben außerhalb der öffentlichen Grenze (FEATURESET.md).
| Ebene | Kanonisches Artefakt | Zweck |
|---|---|---|
| Klon-Identität | ring-config.json | Branding, Feature-Flags, Domains (ring-config.template.json) |
| Secrets und Backend | .env.local | DB_BACKEND_MODE, AUTH_*, Firebase FCM, Deploy-Ziel des Tunnels |
| Anwendungsdaten | PostgreSQL ring_platform | data/schema.sql v4.0.1+ und Kingdom-Migrationen |
| Authentifizierung | Auth.js v5 (auth.ts) | AUTH_SECRET und mindestens ein OAuth-Anbieter für die Anmeldung |
| Entwicklungs-Runtime | server.ts | : Next.js 16 + React 19 + natives WSS, wenn |
Interaktive Wege mit kopierbaren Installationsbefehlen: eigenes Deployment aus GitHub, von LegioX begleitete Anpassung oder Partnerschaft mit Promptor.
Produktion und lokale Entwicklung nutzen DB_BACKEND_MODE=k8s-postgres-fcm: PostgreSQL für die Anwendungsdaten, Firebase Admin nur für FCM-Push, wenn konfiguriert.
Überspringe den Installationsassistenten. Gleiches Ergebnis, mehr Kontrolle:
Im Detail: Installation.
Node.js 20+, Hardware, unterstützte Betriebssysteme, Firebase- und Google-Cloud-Konten
Vollständige Installationswege, Env-Referenz, Tunnel-Konfiguration, Tabelle häufiger Probleme
schema.sql v4.0.1+, Kingdom-Dateien 002–011, Datenbankmatrix der Klone
Smoke-Test für Authentifizierung, Entitäten, Opportunities und API-Health
Checkliste für den White-Label-Klon über den ersten Start hinaus
k8s-postgres-fcm oder supabase-fcm oder firebase-full
Projektstruktur, Tests, Postgres-Bootstrap mit Homebrew
BackendSelector, Adapter, FCM oder Firestore
install.sh: erster Bootstrap des Klons (Konfigurationsdateien + npm install). setup-dev.sh: Härtung der Umgebung nach dem Klonen und optionale Anbindung von Diensten. Nutze npm run setup:env für einen interaktiven, nicht destruktiven Durchgang über eine vorhandene .env.local.
Setze einen White-Label-Klon von Ring Platform auf deinem Rechner auf. Dieser Hub bildet den echten Entwicklungsablauf ab, der im Open-Source-Baum (connectplatform/ring) und auf ring-platform.org verwendet wird, dem Community-Portal für Self-Hosting-Enthusiasten.
| Weg | Zeit | Ergebnis |
|---|---|---|
./install.sh --quick + vorhandenes PostgreSQL | ~20–40 Min. | Klon-Konfiguration, Abhängigkeiten, Env-Gerüst. Schema und OAuth musst du noch selbst anwenden |
| Vollständiger Bootstrap mit Postgres als Primärdatenbank | 45–90 Min. | Lokaler Stack mit Produktionsparität (k8s-postgres-fcm) |
Prototyp (firebase-full) | ~15–30 Min. | Nur Firestore. Ohne die Tiefe von ERP, News Kingdom und PaymentConductor |
Willst du zuerst die Vision kennenlernen? Lies Willkommen bei Ring und komm dann hierher zurück.
Self-Hosting aus GitHub? Folge diesem Abschnitt. Schlüsselfertiges Hosting von Ringdom? Beginne auf ringdom.org. Nach der Übergabe nutzt du den Anpassungsleitfaden. Der öffentliche OSS-Baum enthält install.sh und Community-Skripte. Enterprise-Werkzeuge für k8s und CLI bleiben außerhalb der öffentlichen Grenze (FEATURESET.md).
| Ebene | Kanonisches Artefakt | Zweck |
|---|---|---|
| Klon-Identität | ring-config.json | Branding, Feature-Flags, Domains (ring-config.template.json) |
| Secrets und Backend | .env.local | DB_BACKEND_MODE, AUTH_*, Firebase FCM, Deploy-Ziel des Tunnels |
| Anwendungsdaten | PostgreSQL ring_platform | data/schema.sql v4.0.1+ und Kingdom-Migrationen |
| Authentifizierung | Auth.js v5 (auth.ts) | AUTH_SECRET und mindestens ein OAuth-Anbieter für die Anmeldung |
| Entwicklungs-Runtime | server.ts | : Next.js 16 + React 19 + natives WSS, wenn |
Interaktive Wege mit kopierbaren Installationsbefehlen: eigenes Deployment aus GitHub, von LegioX begleitete Anpassung oder Partnerschaft mit Promptor.
Produktion und lokale Entwicklung nutzen DB_BACKEND_MODE=k8s-postgres-fcm: PostgreSQL für die Anwendungsdaten, Firebase Admin nur für FCM-Push, wenn konfiguriert.
Überspringe den Installationsassistenten. Gleiches Ergebnis, mehr Kontrolle:
Im Detail: Installation.
Node.js 20+, Hardware, unterstützte Betriebssysteme, Firebase- und Google-Cloud-Konten
Vollständige Installationswege, Env-Referenz, Tunnel-Konfiguration, Tabelle häufiger Probleme
schema.sql v4.0.1+, Kingdom-Dateien 002–011, Datenbankmatrix der Klone
Smoke-Test für Authentifizierung, Entitäten, Opportunities und API-Health
Checkliste für den White-Label-Klon über den ersten Start hinaus
k8s-postgres-fcm oder supabase-fcm oder firebase-full
Projektstruktur, Tests, Postgres-Bootstrap mit Homebrew
BackendSelector, Adapter, FCM oder Firestore
install.sh: erster Bootstrap des Klons (Konfigurationsdateien + npm install). setup-dev.sh: Härtung der Umgebung nach dem Klonen und optionale Anbindung von Diensten. Nutze npm run setup:env für einen interaktiven, nicht destruktiven Durchgang über eine vorhandene .env.local.
npm run devRING_DEPLOY_TARGET=self-hostedinstall.sh ausführeninstall.sh v2.0 (siehe INSTALL.md):
ring-config.json aus der Vorlage (--clone-name für den White-Label-Slug)env.local.template → .env.local mit generiertem AUTH_SECRET und WALLET_ENCRYPTION_KEYnpm install ausnext.config.mjs, docker-compose.yml und Dockerfile aus VorlagenFlags: --quick, --clone-name my-ring, --verbose, --help.
Starte Postgres 16+ mit der Datenbank ring_platform (Benutzer ring_user). Optionen:
docker compose -f docker-compose.dev.yml up -d postgres oder ./infrastructure/postgres/bootstrap-brew-dev.shDB_HOST / DB_* in .env.local setzenVollständige Reihenfolge, idempotente Inkremente und Matrix der Ring-Klone: Datenbankmigrationen. Hilfsskript: ./scripts/run-migration.sh, wenn es auf deinen Container ring-postgres-dev zeigt.
Mindestens in .env.local:
Füge die Google-OAuth-Weiterleitung hinzu: http://localhost:3000/api/auth/callback/google.
Interaktiver Env-Assistent (nach dem Kopieren der Vorlage): npm run setup:env oder ./scripts/setup-dev.sh.
Erwartet: Ready on http://localhost:3000 [self-hosted] und natives WSS unter /api/tunnel/ws.
Führe dann die Validierung des ersten Erfolgs aus: Startseite, /login, Entitäten und Opportunities ohne Fehler des Datenbankadapters. Optional: npm run type-check, npm run portal:health.
Öffne http://localhost:3000. Passe das Branding in ring-config.json an und sieh dir die Nächsten Schritte an.
FETCH_FAILED, Wallet-Bootstrap, OAuth-Weiterleitungen, Diagnose
INSTALL.mdnpm run devRING_DEPLOY_TARGET=self-hostedinstall.sh ausführeninstall.sh v2.0 (siehe INSTALL.md):
ring-config.json aus der Vorlage (--clone-name für den White-Label-Slug)env.local.template → .env.local mit generiertem AUTH_SECRET und WALLET_ENCRYPTION_KEYnpm install ausnext.config.mjs, docker-compose.yml und Dockerfile aus VorlagenFlags: --quick, --clone-name my-ring, --verbose, --help.
Starte Postgres 16+ mit der Datenbank ring_platform (Benutzer ring_user). Optionen:
docker compose -f docker-compose.dev.yml up -d postgres oder ./infrastructure/postgres/bootstrap-brew-dev.shDB_HOST / DB_* in .env.local setzenVollständige Reihenfolge, idempotente Inkremente und Matrix der Ring-Klone: Datenbankmigrationen. Hilfsskript: ./scripts/run-migration.sh, wenn es auf deinen Container ring-postgres-dev zeigt.
Mindestens in .env.local:
Füge die Google-OAuth-Weiterleitung hinzu: http://localhost:3000/api/auth/callback/google.
Interaktiver Env-Assistent (nach dem Kopieren der Vorlage): npm run setup:env oder ./scripts/setup-dev.sh.
Erwartet: Ready on http://localhost:3000 [self-hosted] und natives WSS unter /api/tunnel/ws.
Führe dann die Validierung des ersten Erfolgs aus: Startseite, /login, Entitäten und Opportunities ohne Fehler des Datenbankadapters. Optional: npm run type-check, npm run portal:health.
Öffne http://localhost:3000. Passe das Branding in ring-config.json an und sieh dir die Nächsten Schritte an.
FETCH_FAILED, Wallet-Bootstrap, OAuth-Weiterleitungen, Diagnose
INSTALL.mdnpm run devRING_DEPLOY_TARGET=self-hostedinstall.sh ausführeninstall.sh v2.0 (siehe INSTALL.md):
ring-config.json aus der Vorlage (--clone-name für den White-Label-Slug)env.local.template → .env.local mit generiertem AUTH_SECRET und WALLET_ENCRYPTION_KEYnpm install ausnext.config.mjs, docker-compose.yml und Dockerfile aus VorlagenFlags: --quick, --clone-name my-ring, --verbose, --help.
Starte Postgres 16+ mit der Datenbank ring_platform (Benutzer ring_user). Optionen:
docker compose -f docker-compose.dev.yml up -d postgres oder ./infrastructure/postgres/bootstrap-brew-dev.shDB_HOST / DB_* in .env.local setzenVollständige Reihenfolge, idempotente Inkremente und Matrix der Ring-Klone: Datenbankmigrationen. Hilfsskript: ./scripts/run-migration.sh, wenn es auf deinen Container ring-postgres-dev zeigt.
Mindestens in .env.local:
Füge die Google-OAuth-Weiterleitung hinzu: http://localhost:3000/api/auth/callback/google.
Interaktiver Env-Assistent (nach dem Kopieren der Vorlage): npm run setup:env oder ./scripts/setup-dev.sh.
Erwartet: Ready on http://localhost:3000 [self-hosted] und natives WSS unter /api/tunnel/ws.
Führe dann die Validierung des ersten Erfolgs aus: Startseite, /login, Entitäten und Opportunities ohne Fehler des Datenbankadapters. Optional: npm run type-check, npm run portal:health.
Öffne http://localhost:3000. Passe das Branding in ring-config.json an und sieh dir die Nächsten Schritte an.
FETCH_FAILED, Wallet-Bootstrap, OAuth-Weiterleitungen, Diagnose
INSTALL.md