KFZ-Bozo Handbuch

Betrieb & Dokumentation › Umgebungsvariablen (.env.example)

Umgebungsvariablen (.env.example)

BetriebLive✓ Geprüft am Sat Sep 05 2026 02:00:00 GMT+0200 (Mitteleuropäische Sommerzeit)

30 Einstellungen steuern, welche externen Dienste angebunden sind: E-Mail (Microsoft Graph), KI (Anthropic), Zahlungs-/Kassendienst (Fiskaly), Kfz-Bewertung (SilverDAT), Unterschriften-Pad (Signotec), SMS, Google-Bewertungen. Ohne gesetzten Wert bleibt die jeweilige Funktion abgeschaltet statt kaputt.

Entwickler

Bild folgt

30 Einstellungen in einer zentralen Vorlage schalten externe Dienste frei oder aus: E-Mail und Kalender über Microsoft, den KI-Assistenten, das Kassen-/Signaturverfahren, die Fahrzeugdatenbank SilverDAT, das Unterschriften-Pad, den SMS-Versand und die Google-Bewertungen. Fehlt ein Wert, bleibt die jeweilige Funktion abgeschaltet, statt dass etwas abstürzt — Website und Büro-CRM laufen auch ohne jede optionale Anbindung weiter. Ein Teil dieser Werte sind Geheimnisse, die nie in die Versionsverwaltung gehören, der Rest sind gewöhnliche Schalter und Adressen.

  • Eine sichtbare Frontend-Einstellung ändert sich trotz gesetztem Wert nicht → sie muss zur Build-Zeit im Container ankommen, ein einfacher Neustart reicht dafür nicht (Hetzner-Migrations-Runbook).
  • Eine Funktion bleibt trotz gesetztem Schlüssel abgeschaltet → prüfen, ob wirklich alle für diese Funktion nötigen Werte gesetzt sind — mehrere Anbindungen brauchen mehr als einen Wert gleichzeitig.

Gebraucht von

Gebraucht vo…BrauchtBrauchtBrauchtBrauchtBrauchtBrauchtBrauchtBrauchtGenutzt vonUmgebungsv…Backup & Wiede…Microsoft Grap…fiskaly SIGN A…SilverDAT (Fah…Signotec-Unter…SMS-GatewayKI-Anbieter (B…Google Bewertu…Vault-Sichtbar…Cron-Endpunkte…
  • .env.example
secretsGRAPH_CLIENT_SECRET, ANTHROPIC_API_KEY, ADMIN_PASS, ADMIN_SESSION_SECRET, CRON_SECRET, SECRET_STORE_KEY, ZULASSUNGSSCHEIN_WEBHOOK_SECRET, SIGNOTEC_WS_URL(ggf.), FISKALY_API_KEY/SECRET, SILVERDAT_CUSTOMER_PASSWORD, GOOGLE_PLACES_API_KEY
nicht-secretsDOMAIN, PUBLIC_BASE_URL, ADMIN_USER, NEXT_PUBLIC_WHATSAPP_NUMBER, RKSV_PROVIDER, SIGNOTEC_ENABLED/MOCK, FISKALY_ENV, SILVERDAT_ENV, SMS_GATEWAY_ALLOW_PRIVATE, GOOGLE_PLACE_ID
lueckewelche dieser 30 in Prod tatsächlich einen Wert tragen (vs. bewusst leer) ist ohne Server-Zugriff nicht pruefbar — siehe z.B. MEM zu WhatsApp: monatelang trotz Doku nicht sichtbar, weil NEXT_PUBLIC_* nicht im Docker-BUILD ankam

Beleg: .env.example vollstaendig gelistet: 30 Variablen in 8 thematischen Bloecken (Domain/n8n, Graph-Mail, Scan, KI, Admin-Auth, SMS/WhatsApp, Google, Signotec, RKSV/Fiskaly, SilverDAT)

Betrieb & DokumentationSeite bearbeiten: wiki/seiten/betrieb-doku/ops-env.md