E-Mail-Einrichtung

Für einen schnellen Überblick, siehe das hier bereitgestellte Benutzerhandbuch: Passwort zurücksetzen

Allgemeine Einrichtung

LibreChat unterstützt mehrere E-Mail-Anbieter:

• Mailgun API - Empfohlen für Server, die SMTP-Ports blockieren
• SMTP-Dienste - Traditioneller E-Mail-Versand über Gmail, Outlook oder benutzerdefinierte E-Mail-Server

Allgemeine Konfiguration

Diese Variablen werden sowohl von Mailgun als auch von SMTP verwendet:

Mailgun-Konfiguration (Empfohlen)

Mailgun ist besonders nützlich für Bereitstellungen auf Servern, die SMTP-Ports blockieren, um Spam zu verhindern. Wenn sowohl MAILGUN_API_KEY als auch MAILGUN_DOMAIN festgelegt sind, verwendet LibreChat Mailgun anstelle von SMTP.

SMTP-Konfiguration

Grundlegende Konfiguration

Wenn Sie einen der vordefinierten Dienste nutzen möchten, konfigurieren Sie nur diese Variablen: Weitere Informationen zu unterstützten E-Mail-Diensten finden Sie unter: https://community.nodemailer.com/2-0-0-beta/setup-smtp/well-known-services/

Erweiterte Konfiguration

Wenn Sie einen generischen SMTP-Dienst verwenden möchten oder eine erweiterte Konfiguration für einen der vordefinierten Anbieter benötigen, konfigurieren Sie zusätzlich diese Variablen:

Einrichtung mit Mailgun

Um Mailgun einzurichten, befolgen Sie diese Schritte:

1. Registrieren Sie sich für ein Mailgun-Konto unter mailgun.com
2. Fügen Sie Ihre Domain im Mailgun-Dashboard hinzu und verifizieren Sie diese.
3. Navigieren Sie zum Abschnitt API Keys und kopieren Sie Ihren privaten API-Schlüssel.
4. Ändern Sie in der .env Datei die Variablen wie folgt:

Einrichtung mit Gmail

Um Gmail einzurichten, befolgen Sie diese Schritte:

1. Erstellen Sie ein Google-Konto und aktivieren Sie die Bestätigung in zwei Schritten.
2. Klicken Sie in den Google Account settings auf den Tab „Sicherheit“ und öffnen Sie die „Bestätigung in zwei Schritten“.
3. Scrollen Sie nach unten und öffnen Sie "App passwords." Wählen Sie "Mail" für die App und "Other" für das Gerät aus, und vergeben Sie anschließend einen beliebigen Namen.
4. Klicken Sie auf „Generate“, um ein Passwort zu erstellen, und kopieren Sie das generierte Passwort.
5. Ändern Sie in der .env Datei die Variablen wie folgt:

Einrichtung mit benutzerdefiniertem Mail-Server

Um einen benutzerdefinierten Mailserver einzurichten, befolgen Sie diese Schritte:

1. Sammeln Sie Ihre SMTP-Anmeldedaten von Ihrem Anbieter. Die Schritte sind je nach Anbieter unterschiedlich, aber in der Regel werden dort Werte für alle Variablen aufgelistet.
2. Ändern Sie in der .env Datei die Variablen wie folgt, unter Annahme einiger sinnvoller Beispielwerte:

Vollständige Konfigurationsbeispiele

Beispiel 1: Mailgun-Konfiguration

# ===================================
# Email Configuration - Mailgun
# ===================================
# Mailgun is recommended for servers that block SMTP ports
 
# Required Mailgun settings
MAILGUN_API_KEY=your-mailgun-api-key
MAILGUN_DOMAIN=mg.yourdomain.com
 
# Optional: For EU region
# MAILGUN_HOST=https://api.eu.mailgun.net
 
# Common email settings
EMAIL_FROM=[email protected]
EMAIL_FROM_NAME=LibreChat
 
# Enable password reset functionality
ALLOW_PASSWORD_RESET=true

Beispiel 2: Gmail SMTP-Konfiguration

# ===================================
# Email Configuration - Gmail SMTP
# ===================================
# Traditional SMTP configuration
 
# Gmail service configuration
EMAIL_SERVICE=gmail
EMAIL_USERNAME=[email protected]
EMAIL_PASSWORD=your-app-password
 
# Common email settings
EMAIL_FROM=[email protected]
EMAIL_FROM_NAME=LibreChat
 
# Enable password reset functionality
ALLOW_PASSWORD_RESET=true

Beispiel 3: Benutzerdefinierte SMTP-Server-Konfiguration

# ===================================
# Email Configuration - Custom SMTP
# ===================================
# For custom mail servers
 
# SMTP server details
EMAIL_HOST=smtp.example.com
EMAIL_PORT=587
EMAIL_ENCRYPTION=starttls
EMAIL_USERNAME=[email protected]
EMAIL_PASSWORD=your-password
 
# Optional settings
# EMAIL_ENCRYPTION_HOSTNAME=
# EMAIL_ALLOW_SELFSIGNED=false
 
# Common email settings
EMAIL_FROM=[email protected]
EMAIL_FROM_NAME=LibreChat
 
# Enable password reset functionality
ALLOW_PASSWORD_RESET=true

Fehlerbehebung

Mailgun-Probleme

1. Authentifizierung fehlgeschlagen: Stellen Sie sicher, dass Ihr Mailgun API-Schlüssel korrekt ist und über Berechtigungen zum Senden verfügt.
2. Domain Not Found: Überprüfen Sie, ob Ihre Mailgun-Domain in Ihrem Mailgun-Konto korrekt konfiguriert ist.
3. EU-Regionsprobleme: Wenn sich Ihr Mailgun-Konto in der EU-Region befindet, stellen Sie sicher, dass MAILGUN_HOST=https://api.eu.mailgun.net gesetzt ist.
4. Fallback auf SMTP: Wenn nur einer der Werte MAILGUN_API_KEY oder MAILGUN_DOMAIN gesetzt ist, greift das System auf die SMTP-Konfiguration zurück.

SMTP-Probleme

1. Connection Refused: Überprüfen Sie, ob Ihr Server ausgehende SMTP-Verbindungen auf dem angegebenen Port zulässt
2. Authentifizierung fehlgeschlagen: Überprüfen Sie, ob Ihr Benutzername und Ihr Passwort korrekt sind
3. Gmail App-Passwort: Für Gmail müssen Sie ein App-spezifisches Passwort verwenden, nicht Ihr reguläres Passwort.
4. Selbstsignierte Zertifikate: Wenn Ihr Mailserver selbstsignierte Zertifikate verwendet, setzen Sie EMAIL_ALLOW_SELFSIGNED=true

Allgemeine Probleme

1. Keine E-Mails versendet: Überprüfen Sie die LibreChat-Protokolle auf Fehlermeldungen
2. Unsicheres Zurücksetzen des Passworts: Dies tritt auf, wenn weder Mailgun noch SMTP ordnungsgemäß konfiguriert sind
3. Probleme mit der Absenderadresse: Stellen Sie sicher, dass die EMAIL_FROM-Adresse gültig ist und autorisiert wurde, über Ihren E-Mail-Dienst zu senden.