README: .env als kopierbare Vorlage statt nur Tabelle #4

Merged
hru merged 1 commit from docs/env-template into main 2026-07-28 20:23:37 +00:00
Owner

Die Tabelle listete Variablen, ohne zu sagen, welche zusammen eine lauffähige
Konfiguration ergeben. Jetzt steht eine vollständige, mit Defaults gefüllte
.env am Anfang; die Tabelle bleibt als Nachschlagewerk darunter.

Drei Dinge, die beim Prüfen am Code herauskamen und jetzt dokumentiert sind:

  • IMAP_* und KANBOARD_* sind nur Vorbelegungen der Einstellungsseite. Die
    echten Zugangsdaten liegen verschlüsselt in der Datenbank; KANBOARD_TOKEN
    und IMAP_PASSWORD liest zur Laufzeit niemand, sie dienen allein der
    einmaligen KMS-Provisionierung im Entrypoint.
  • Ein leer gesetzter Wert ist nicht dasselbe wie ein fehlender: MAIL_DEFAULT_
    SENDER= ergäbe einen leeren Absender statt MAIL_USERNAME, GUNICORN_WORKERS=
    lässt Gunicorn an int("") abstürzen. Beide Zeilen sind auskommentiert.
  • Was docker-compose.yml selbst per environment: setzt, hat in der .env keine
    Wirkung — das ist jetzt benannt.

Die Vorlage wurde extrahiert und getestet: compose config ohne Warnungen,
Stack startet allein damit, MAIL_DEFAULT_SENDER fällt korrekt zurück.

Co-Authored-By: Claude Opus 5 noreply@anthropic.com

Die Tabelle listete Variablen, ohne zu sagen, welche zusammen eine lauffähige Konfiguration ergeben. Jetzt steht eine vollständige, mit Defaults gefüllte .env am Anfang; die Tabelle bleibt als Nachschlagewerk darunter. Drei Dinge, die beim Prüfen am Code herauskamen und jetzt dokumentiert sind: - IMAP_* und KANBOARD_* sind nur Vorbelegungen der Einstellungsseite. Die echten Zugangsdaten liegen verschlüsselt in der Datenbank; KANBOARD_TOKEN und IMAP_PASSWORD liest zur Laufzeit niemand, sie dienen allein der einmaligen KMS-Provisionierung im Entrypoint. - Ein leer gesetzter Wert ist nicht dasselbe wie ein fehlender: MAIL_DEFAULT_ SENDER= ergäbe einen leeren Absender statt MAIL_USERNAME, GUNICORN_WORKERS= lässt Gunicorn an int("") abstürzen. Beide Zeilen sind auskommentiert. - Was docker-compose.yml selbst per environment: setzt, hat in der .env keine Wirkung — das ist jetzt benannt. Die Vorlage wurde extrahiert und getestet: compose config ohne Warnungen, Stack startet allein damit, MAIL_DEFAULT_SENDER fällt korrekt zurück. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Die Tabelle listete Variablen, ohne zu sagen, welche zusammen eine lauffähige
Konfiguration ergeben. Jetzt steht eine vollständige, mit Defaults gefüllte
.env am Anfang; die Tabelle bleibt als Nachschlagewerk darunter.

Drei Dinge, die beim Prüfen am Code herauskamen und jetzt dokumentiert sind:

- IMAP_* und KANBOARD_* sind nur Vorbelegungen der Einstellungsseite. Die
  echten Zugangsdaten liegen verschlüsselt in der Datenbank; KANBOARD_TOKEN
  und IMAP_PASSWORD liest zur Laufzeit niemand, sie dienen allein der
  einmaligen KMS-Provisionierung im Entrypoint.
- Ein leer gesetzter Wert ist nicht dasselbe wie ein fehlender: MAIL_DEFAULT_
  SENDER= ergäbe einen leeren Absender statt MAIL_USERNAME, GUNICORN_WORKERS=
  lässt Gunicorn an int("") abstürzen. Beide Zeilen sind auskommentiert.
- Was docker-compose.yml selbst per environment: setzt, hat in der .env keine
  Wirkung — das ist jetzt benannt.

Die Vorlage wurde extrahiert und getestet: compose config ohne Warnungen,
Stack startet allein damit, MAIL_DEFAULT_SENDER fällt korrekt zurück.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
hru merged commit f58ff7df10 into main 2026-07-28 20:23:37 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
hru/VMS!4
No description provided.