Umgebungsvariablen¶

Umgebungsvariablen überschreiben die Standardwerte und eignen sich für Server-Deployments.

Backend-Umgebungsvariablen¶

Konfigurationsdatei: backend/.env

Variable	Standard	Beschreibung
`PORT`	`3001`	Port des Express-Servers
`DB_PATH`	`./data/ripster.db`	Pfad zur SQLite-Datenbankdatei
`CORS_ORIGIN`	`http://localhost:5173`	Erlaubter CORS-Origin
`LOG_DIR`	`./logs`	Verzeichnis für Log-Dateien
`LOG_LEVEL`	`info`	Log-Level (`debug`, `info`, `warn`, `error`)

PORT=3001
DB_PATH=/var/lib/ripster/ripster.db
CORS_ORIGIN=http://192.168.1.100:5173
LOG_DIR=/var/log/ripster
LOG_LEVEL=info

Konfigurationsdatei: frontend/.env

Variable	Standard	Beschreibung
`VITE_API_BASE`	`http://localhost:3001`	Backend-API-URL
`VITE_WS_URL`	`ws://localhost:3001`	WebSocket-URL
`VITE_PUBLIC_ORIGIN`	—	Öffentliche Origin-URL (für CORS)
`VITE_HMR_HOST`	—	Vite HMR-Host (für Remote-Entwicklung)
`VITE_HMR_PORT`	—	Vite HMR-Port

VITE_API_BASE=http://localhost:3001
VITE_WS_URL=ws://localhost:3001

VITE_API_BASE=http://192.168.1.100:3001
VITE_WS_URL=ws://192.168.1.100:3001
VITE_PUBLIC_ORIGIN=http://192.168.1.100:5173

Das Repository enthält Vorlagen für beide Konfigurationsdateien:

# Backend
cp backend/.env.example backend/.env

# Frontend
cp frontend/.env.example frontend/.env

Einstellungen werden in folgender Reihenfolge geladen (höhere Priorität überschreibt niedrigere):

1. Systemumgebungsvariablen (export VAR=value)
2. .env-Datei
3. Hardcodierte Standardwerte in config.js

Level	Ausgabe
`debug`	Alle Meldungen inkl. Debugging
`info`	Normale Betriebsinformationen
`warn`	Warnungen + Fehler
`error`	Nur Fehler

Produktionsempfehlung

Für Produktionsumgebungen LOG_LEVEL=info oder LOG_LEVEL=warn verwenden. debug erzeugt sehr viele Log-Einträge.