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