SMTP (E-Mail)

Klokk verschickt E-Mails für Einladungen, Passwort-Zurücksetzungen, entschiedene Anträge, Schichtpläne und weitere Benachrichtigungen – über einen SMTP-Server Ihrer Wahl.

Variablen

Variable	Standard	Beschreibung
SMTP_HOST	leer	Hostname des SMTP-Servers. Leer schaltet E-Mail aus.
SMTP_PORT	587	587 für STARTTLS, 465 für implizites TLS.
SMTP_TLS	false	true = implizites TLS (Port 465); false = STARTTLS (Port 587).
SMTP_USER	—	Benutzername für die Anmeldung am Server.
SMTP_PASS	—	Passwort; besser als Datei: SMTP_PASS_FILE=/run/secrets/smtp_pass.
SMTP_FROM	SMTP_USER	Absenderadresse wie [email protected] oder mit Anzeigenamen: Klokk <[email protected]> (nur die Adresse – mit Anzeigenamen lehnt der Server die E-Mail ab). Leer: der Benutzername.

Wie jede Variable kann das Passwort aus einer Datei kommen (Docker-Secrets) – siehe Umgebungsvariablen.

Verschlüsselung und Anmeldung

Klokk versendet immer verschlüsselt und angemeldet:

• mit SMTP_TLS=false beginnt die Verbindung unverschlüsselt und wechselt per STARTTLS zu TLS – ein Server ohne STARTTLS wird abgelehnt;
• mit SMTP_TLS=true ist die Verbindung von Anfang an TLS (Port 465).

Das Zertifikat des Servers muss für SMTP_HOST gültig sein. Ein Mail-Relay ohne Verschlüsselung oder ohne Anmeldung funktioniert nicht.

Beispiele

STARTTLS (Port 587)

SMTP_HOST=smtp.example.de
SMTP_PORT=587
SMTP_USER=[email protected]
SMTP_PASS_FILE=/run/secrets/smtp_pass
SMTP_FROM=[email protected]

Implizites TLS (Port 465)

SMTP_HOST=smtp.example.de
SMTP_PORT=465
SMTP_TLS=true
SMTP_USER=[email protected]
SMTP_PASS_FILE=/run/secrets/smtp_pass

Tipp

Bei Microsoft 365 oder Google Workspace ein Postfach oder App-Passwort verwenden, das für SMTP-Versand gedacht ist; viele Anbieter sperren die einfache SMTP-Anmeldung für normale Konten.

Ohne E-Mail

Ohne SMTP_HOST läuft Klokk vollständig, verschickt aber nichts: Die Benachrichtigungseinstellungen zeigen „kein SMTP“, Passwort-Zurücksetzen per E-Mail entfällt, und Push-Benachrichtigungen sind der einzige Weg, benachrichtigt zu werden.

Wenn etwas nicht klappt

Klokk protokolliert jeden Versuch mit Empfänger, Modus (TLS/STARTTLS), Server und Absender sowie gegebenenfalls den Fehler – etwa smtp auth: … bei falschen Zugangsdaten, smtp starttls: …, wenn der Server kein STARTTLS anbietet, oder smtp mail from: …, wenn der Server den Absender ablehnt.