Installation (Entwicklung)

import { Aside } from ‘@astrojs/starlight/components’;

Diese Anleitung richtet sich an lokale Entwicklung und an eine Evaluation ohne Docker. Für Produktion siehe Deployment.

Voraussetzungen

Anforderung	Version
Node.js	22 LTS oder 24
Yarn	Wie im Repo verwendet
PostgreSQL	16+
Redis	7+

1. Klonen und Abhängigkeiten

git clone https://github.com/defcon1702/orimora.git orimora
cd orimora
yarn install

2. Datenbanken

Leere PostgreSQL-Datenbank anlegen; Redis erreichbar machen:

createdb knowledgebase
redis-cli ping   # → PONG

3. Umgebungsvariablen

cp .env.example .env

Minimum für einen laufenden Dev-Server:

Variable	Zweck
`DATABASE_URL`	PostgreSQL-Verbindungszeichenkette
`REDIS_URL`	z. B. `redis://localhost:6379`
`APP_URL`	Öffentliche Basis-URL — unter Vite meist `http://localhost:5173`
`SESSION_SECRET`	64 Hex-Zeichen
`MAGIC_LINK_SECRET`	ebenfalls 64 Hex-Zeichen (eigener Wert)
`LLM_ENCRYPTION_KEY`	64 Hex-Zeichen — auch ohne KI nötig (Verschlüsselung gespeicherter LLM-Keys)

SMTP kann leer bleiben, wenn du E-Mail-Links in der Entwicklung nicht brauchst (OAuth oder andere Loginpfade).

4. Migrationen

yarn db:migrate

Nach jedem git pull mit neuen Migrationen wiederholen.

5. Dev-Server

yarn dev

Browser unter APP_URL öffnen, Onboarding durchführen.

6. Health-Check

curl -s http://localhost:5173/api/health

Kollaboration (optional)

Der Editor nutzt WebSockets auf /collab. In der Entwicklung übernimmt das Vite-Plugin den Upgrade — Firewalls/Policies dürfen WebSockets nicht blockieren.

Häufige Probleme

Symptom	Prüfen
DB-Verbindung	Postgres läuft, `DATABASE_URL` stimmt
Redis-Fehler	`REDIS_URL`, `redis-cli ping`
Migration schlägt fehl	Benutzer hat Rechte, gleiche URL wie die App
401 auf `/api/v1/*`	`Authorization: Bearer kb_…` aus Einstellungen → Entwickler