Wissen / Einrichtung
Mailversand einrichten
SMTP-Einstellungen für Erinnerungen, Einladungen und Berichte, mit Test.
Ohne Mailversand protokolliert Kontris Erinnerungen nur. Mit Mailversand gehen Erinnerungen, Eskalationen, Aufgabenübersichten, Berichte und Einladungen an die Benutzer.
Einstellungen
Mailserver mit Anmeldung (üblich):
MAIL_ENABLED=true
SMTP_HOST=mail.example.com
SMTP_PORT=587
SMTP_SECURITY=starttls
SMTP_USER=contracthub@example.com
SMTP_PASSWORD=<Passwort>
SMTP_FROM=Kontris <contracthub@example.com>
Internes Relay ohne Anmeldung:
MAIL_ENABLED=true
SMTP_HOST=relay.example.local
SMTP_PORT=25
SMTP_SECURITY=starttls
SMTP_FROM=Kontris <contracthub@example.com>
SMTP_SECURITY |
Bedeutung | Üblicher Port |
|---|---|---|
tls |
Verschlüsselt ab dem ersten Byte | 465 |
starttls |
Umstieg auf TLS ist Pflicht, sonst Abbruch | 587 oder 25 |
none |
Unverschlüsselt, nur für ein Relay ohne Anmeldung | 25 |
Kontris fällt nie auf Klartext zurück und prüft Zertifikate immer. Viele Server erlauben als Absender nur die Adresse des Anmeldekontos.
Zertifikat einer eigenen Zertifizierungsstelle
SMTP_TLS_CA_FILE=/certs/mail-ca.pem
# nur wenn der Name im Zertifikat von SMTP_HOST abweicht
SMTP_TLS_SERVERNAME=relay.example.local
volumes:
- ./mail-ca.pem:/certs/mail-ca.pem:ro
Testen
Nach dem Neustart (docker compose up -d --force-recreate contracthub):
# nur die Verbindung und Anmeldung prüfen
docker compose exec contracthub node dist/mail-test.js
# Testmail senden
docker compose exec contracthub node dist/mail-test.js du@example.com
Ohne Kommandozeile: Verwaltung → Benachrichtigungen → Testmail senden zeigt die Antwort des Mailservers direkt an.
Zeitpunkt der Prüfung
Die tägliche Fristenprüfung läuft um 6 Uhr in der Zeitzone TZ. Mit NOTIFY_CRON änderst du die Uhrzeit. War der Server zu der Zeit aus, wird der Lauf beim nächsten Start nachgeholt. Ein zweiter Lauf am selben Tag verschickt nichts doppelt.
Häufige Fehler
| Meldung | Ursache | Abhilfe |
|---|---|---|
Invalid login |
Benutzer oder Passwort falsch, oder SMTP AUTH ist für das Postfach gesperrt | Zugangsdaten prüfen. Bei Microsoft 365 „Authenticated SMTP“ am Postfach erlauben |
UNABLE_TO_GET_ISSUER_CERT_LOCALLY, self-signed certificate |
Zertifikat einer eigenen Zertifizierungsstelle | SMTP_TLS_CA_FILE setzen |
Hostname/IP does not match certificate's altnames |
Name im Zertifikat weicht ab | SMTP_TLS_SERVERNAME setzen |
ECONNREFUSED, Timeout |
Port gesperrt | Firewall prüfen |
| Status „Protokolliert“ | MAIL_ENABLED=false |
Mailversand einschalten |
Links in Mails bauen auf APP_BASE_URL auf. Der Wert muss die Adresse sein, unter der Benutzer Kontris tatsächlich erreichen.
Stand 15.11.2026 · Kommst du nicht weiter? Schreib uns