---
title: "Erste Schritte"
description: "Ring Platform lokal aufsetzen: install.sh, Backend mit PostgreSQL als primärer Datenbank, Auth.js v5, Schema-Migrationen und Validierung des ersten Erfolgs"
locale: "de"
---
# Erste Schritte

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](https://github.com/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](/docs/welcome.md) und komm dann hierher zurück.

**Self-Hosting aus GitHub?** Folge diesem Abschnitt. **Schlüsselfertiges Hosting von Ringdom?** Beginne auf [ringdom.org](https://ringdom.org). Nach der Übergabe nutzt du den [Anpassungsleitfaden](/docs/customization/customization-guide.md). 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`](https://github.com/connectplatform/ring/blob/main/FEATURESET.md)).

## Was du konfigurierst

| 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` | `npm run dev`: Next.js 16 + React 19 + natives WSS, wenn `RING_DEPLOY_TARGET=self-hosted` |

## Drei Wege zu Ring Platform

Interaktive Wege mit **kopierbaren Installationsbefehlen**: eigenes Deployment aus GitHub, von LegioX begleitete Anpassung oder Partnerschaft mit Promptor.

## Empfohlener Bootstrap (Postgres als Primärdatenbank)

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.

### 1. Klonen und `install.sh` ausführen

{`git clone https://github.com/connectplatform/ring.git
cd ring
chmod +x install.sh
./install.sh --quick`}

`install.sh` v2.0 (siehe [`INSTALL.md`](https://github.com/connectplatform/ring/blob/main/INSTALL.md)):

- Prüft die Systemanforderungen (Node.js 20+, npm 10+)
- Erstellt **`ring-config.json`** aus der Vorlage (`--clone-name` für den White-Label-Slug)
- Kopiert **`env.local.template`** → **`.env.local`** mit generiertem `AUTH_SECRET` und `WALLET_ENCRYPTION_KEY`
- Führt **`npm install`** aus
- Erzeugt optional `next.config.mjs`, `docker-compose.yml` und `Dockerfile` aus Vorlagen

Flags: `--quick`, `--clone-name my-ring`, `--verbose`, `--help`.

### 2. PostgreSQL bereitstellen

Starte Postgres 16+ mit der Datenbank **`ring_platform`** (Benutzer **`ring_user`**). Optionen:

- **Docker**: ein Container für die Entwicklung (siehe [Installation](/docs/getting-started/installation.md#postgresql-einrichten))
- **Ringdom-Monorepo**: `docker compose -f docker-compose.dev.yml up -d postgres` oder `./infrastructure/postgres/bootstrap-brew-dev.sh`
- **Vorhandener Server**: Datenbank anlegen und `DB_HOST` / `DB_*` in `.env.local` setzen

### 3. Schema und Kingdom-Migrationen anwenden

{`export DATABASE_URL="postgresql://ring_user:ring_password_2024@localhost:5432/ring_platform"
psql "$DATABASE_URL" -f data/schema.sql
psql "$DATABASE_URL" -f data/migrations/002_news_content_schema.sql
psql "$DATABASE_URL" -f data/migrations/003_news_kingdom_upgrade.sql
psql "$DATABASE_URL" -f data/migrations/004_payment_transactions.sql`}

Vollständige Reihenfolge, idempotente Inkremente und Matrix der Ring-Klone: [Datenbankmigrationen](/docs/getting-started/migrations.md). Hilfsskript: `./scripts/run-migration.sh`, wenn es auf deinen Container `ring-postgres-dev` zeigt.

### 4. Authentifizierung und lokale URLs abschließen

Mindestens in `.env.local`:

{`DB_BACKEND_MODE=k8s-postgres-fcm
AUTH_SECRET=          # openssl rand -base64 32
AUTH_GOOGLE_ID=
AUTH_GOOGLE_SECRET=
NEXT_PUBLIC_BASE_URL=http://localhost:3000
RING_DEPLOY_TARGET=self-hosted
NEXT_PUBLIC_RING_DEPLOY_TARGET=self-hosted`}

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`.

### 5. Entwicklungsserver starten und validieren

{`npm run dev`}

Erwartet: `Ready on http://localhost:3000 [self-hosted]` und natives WSS unter `/api/tunnel/ws`.

Führe dann die [Validierung des ersten Erfolgs](/docs/getting-started/first-success.md) aus: Startseite, `/login`, Entitäten und Opportunities ohne Fehler des Datenbankadapters. Optional: `npm run type-check`, `npm run portal:health`.

Öffne [http://localhost:3000](http://localhost:3000). Passe das Branding in `ring-config.json` an und sieh dir die [Nächsten Schritte](/docs/getting-started/next-steps.md) an.

## Alternative Wege

Überspringe den Installationsassistenten. Gleiches Ergebnis, mehr Kontrolle:

{`git clone https://github.com/connectplatform/ring.git
cd ring
npm install
cp env.local.template .env.local
cp ring-config.template.json ring-config.json
# edit ring-config.json + .env.local
# provision PostgreSQL + apply migrations (steps 2–3 above)
npm run dev`}

Im Detail: [Installation](/docs/getting-started/installation.md).

Schnelles Prototyping am Vercel-Edge. **Nicht** die Produktionsdatenebene von ring-platform.org:

{`DB_BACKEND_MODE=firebase-full`}

Konfiguriere Firebase Admin und die Client-Schlüssel aus `env.local.template`. `data/schema.sql` ist nicht nötig. Fehlende Funktionen: [Datenbankauswahl](/docs/customization/database-selection.md).

Wenn `ring-platform.org` im Kingdom-Checkout von Ringdom liegt:

{`docker compose -f docker-compose.dev.yml up -d postgres
cd ring-platform.org
npm install
# .env.local already or: npm run setup:env
npm run dev`}

Postgres-Manifest für mehrere Klone: `infrastructure/postgres/DEV-DATABASE-MANIFEST.json`.

## Anleitungen in diesem Abschnitt

  
- **[Voraussetzungen](/docs/getting-started/prerequisites.md)** — Node.js 20+, Hardware, unterstützte Betriebssysteme, Firebase- und Google-Cloud-Konten

  
- **[Installation](/docs/getting-started/installation.md)** — Vollständige Installationswege, Env-Referenz, Tunnel-Konfiguration, Tabelle häufiger Probleme

  
- **[Datenbankmigrationen](/docs/getting-started/migrations.md)** — `schema.sql` v4.0.1+, Kingdom-Dateien 002–011, Datenbankmatrix der Klone

  
- **[Validierung des ersten Erfolgs](/docs/getting-started/first-success.md)** — Smoke-Test für Authentifizierung, Entitäten, Opportunities und API-Health

  
- **[Fehlerbehebung](/docs/getting-started/troubleshooting.md)** — FETCH_FAILED, Wallet-Bootstrap, OAuth-Weiterleitungen, Diagnose

  
- **[Nächste Schritte](/docs/getting-started/next-steps.md)** — Admin, erste Entität, Opportunities, Messaging, Verweis auf das Deployment

## Verwandte Dokumentation

  
- **[Schnellstart Anpassung](/docs/customization/quick-start.md)** — Checkliste für den White-Label-Klon über den ersten Start hinaus

  
- **[Auswahl des Datenbank-Backends](/docs/customization/database-selection.md)** — `k8s-postgres-fcm` oder `supabase-fcm` oder `firebase-full`

  
- **[Lokale Entwicklungsumgebung](/docs/development/local-setup.md)** — Projektstruktur, Tests, Postgres-Bootstrap mit Homebrew

  
- **[Architektur: Backend-Modi](/docs/architecture/backend-modes-and-databases.md)** — BackendSelector, Adapter, FCM oder Firestore

## Kurzreferenz: Bootstrap-Befehle

| Aufgabe | Befehl |
|------|---------|
| Installation mit einem Befehl | `git clone … && ./install.sh --quick` |
| Env-Assistent | `npm run setup:env` |
| Skript für die Entwicklungsumgebung | `./scripts/setup-dev.sh` |
| Migrationsdatei anwenden | `./scripts/run-migration.sh data/schema.sql` |
| Entwicklungsserver | `npm run dev` |
| Typprüfung | `npm run type-check` |
| Portal-Health | `npm run portal:health` |
| Installationsleitfaden im Repo | [`INSTALL.md`](https://github.com/connectplatform/ring/blob/main/INSTALL.md) |

**`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`.
