Schnellstart (lokal)

Diese Anleitung startet Clavis lokal für Entwicklung und Tests.

Voraussetzungen

• Docker 24+ und Docker Compose v2 installiert
• Git installiert

Schritt 1: Repository klonen

git clone https://github.com/Clavis-Rallye/App.git
cd App

Schritt 2: Umgebungsvariablen konfigurieren

cp deployment/.env.example .env

Öffne .env und setze mindestens:

• JWT_SECRET_KEY — zufälliger String (≥32 Zeichen)
• HMAC_AUDIT_KEY — zufälliger String (≥32 Zeichen)
• POSTGRES_PASSWORD — Datenbankpasswort

Alle weiteren Variablen haben sinnvolle Standardwerte für die lokale Entwicklung.

Schritt 3: Dienste starten

docker compose up --build

Beim ersten Start werden alle Images gebaut und die Datenbank initialisiert. Das dauert einige Minuten.

Schritt 4: Zugriff

Dienst	URL
Frontend	http://localhost:8000
API-Dokumentation	http://localhost:8000/api/docs
ReDoc	http://localhost:8000/api/redoc
MinIO-Konsole	http://localhost:9001

Stoppen

docker compose down

Datenbankdaten bleiben im Docker-Volume erhalten.