Umgebungsvariablen
Vollständige Referenz aller .env-Variablen.
Pflichtfelder
Variablen ohne Defaultwert müssen gesetzt werden — das Backend startet sonst nicht korrekt.
App
| Variable | Beispielwert | Pflicht | Beschreibung |
|---|---|---|---|
APP_NAME | Venturo | Ja | Anwendungsname |
APP_ENV | local / production | Ja | Umgebung |
APP_KEY | base64:... | Ja | Verschlüsselungskey — per php artisan key:generate |
APP_DEBUG | true / false | Ja | Debug-Modus — in Produktion immer false |
APP_URL | https://api.saw-sg.de | Ja | Backend-URL |
Datenbank
| Variable | Beispielwert | Pflicht | Beschreibung |
|---|---|---|---|
DB_CONNECTION | mysql | Ja | Datenbank-Treiber |
DB_HOST | 127.0.0.1 | Ja | MySQL-Host |
DB_PORT | 3306 | Ja | MySQL-Port |
DB_DATABASE | venturo | Ja | Datenbankname |
DB_USERNAME | venturo | Ja | Datenbanknutzer |
DB_PASSWORD | secret | Ja | Datenbankpasswort |
Redis
| Variable | Beispielwert | Pflicht | Beschreibung |
|---|---|---|---|
REDIS_HOST | 127.0.0.1 | Ja | Redis-Host |
REDIS_PORT | 6379 | Nein | Redis-Port (Default: 6379) |
REDIS_PASSWORD | null | Nein | Redis-Passwort (meist leer lokal) |
Session / Queue / Cache
| Variable | Lokal | Produktion | Beschreibung |
|---|---|---|---|
SESSION_DRIVER | file | redis | Session-Speicher |
QUEUE_CONNECTION | database | redis | Queue-Backend — lokal kein Redis nötig |
CACHE_STORE | file | redis | Cache-Backend |
Lokal kein Redis nötig
Für lokale Entwicklung reichen database und file. Redis (und Horizon) laufen nur in Produktion auf dem Coolify-Server. Der lokale Queue Worker startet mit php artisan queue:work (via dev-horizon.ps1).
Mail
| Variable | Lokal | Produktion | Beschreibung |
|---|---|---|---|
MAIL_MAILER | smtp | smtp | Mail-Treiber |
MAIL_HOST | mailpit / 127.0.0.1 | smtp.brevo.com | SMTP-Host |
MAIL_PORT | 1025 | 587 | SMTP-Port |
MAIL_USERNAME | null | <smtp-user> | SMTP-Nutzer |
MAIL_PASSWORD | null | <smtp-pw> | SMTP-Passwort |
MAIL_FROM_ADDRESS | noreply@saw-sg.de | noreply@saw-sg.de | Absender-Adresse |
MAIL_FROM_NAME | Venturo | Venturo | Absender-Name |
Lokal
Lokal wird Mailpit verwendet (localhost:8025). Alle gesendeten Mails landen dort — kein echtes Versenden an echte Adressen.
Venturo Connector
| Variable | Beispielwert | Pflicht | Beschreibung |
|---|---|---|---|
N8N_WEBHOOK_BASE | https://n8n.saw-sg.de/webhook | Ja | n8n-Basis-URL für Webhooks |
N8N_WEBHOOK_SECRET | <zufallsstring> | Ja | Shared Secret für n8n-Webhooks |
Anthropic Claude API
| Variable | Beispielwert | Pflicht | Beschreibung |
|---|---|---|---|
ANTHROPIC_API_KEY | sk-ant-... | Ja | Claude API Key |
ANTHROPIC_DEFAULT_MODEL | claude-haiku-4-5-20251001 | Nein | Modell für KI-Kunden-Agenten |
ANTHROPIC_COACH_MODEL | claude-sonnet-4-6 | Nein | Modell für KI-Coach (höhere Qualität) |
API Key sicher aufbewahren
Den API Key niemals committen. Er steht nur in .env (lokal) oder in Coolify Environment Variables (Produktion).
CORS / Sanctum
| Variable | Lokal | Produktion | Beschreibung |
|---|---|---|---|
FRONTEND_URL | http://localhost:5173 | https://venturo.saw-sg.de | Frontend-URL für CORS |
SANCTUM_STATEFUL_DOMAINS | localhost:5173 | venturo.saw-sg.de | Sanctum SPA-Domains |
Frontend (.env.local / .env.production)
| Variable | Lokal | Produktion | Beschreibung |
|---|---|---|---|
VITE_API_BASE_URL | http://localhost:8080 | https://api.saw-sg.de | Backend-API-URL |
Vollständiges .env.example
Die Datei backend/.env.example enthält alle Variablen als Vorlage mit Kommentaren. Für lokale Einrichtung: cp backend/.env.example backend/.env