Configuration des e-mails

Pour un aperçu rapide, consultez le guide de l'utilisateur fourni ici : Réinitialisation du mot de passe

Configuration générale

LibreChat prend en charge plusieurs fournisseurs d'e-mail :

• Mailgun API - Recommandé pour les serveurs qui bloquent les ports SMTP
• Services SMTP - Envoi d'e-mails traditionnel via Gmail, Outlook ou des serveurs de messagerie personnalisés

Configuration courante

Ces variables sont utilisées à la fois par Mailgun et SMTP :

Configuration de Mailgun (Recommandé)

Mailgun est particulièrement utile pour les déploiements sur des serveurs qui bloquent les ports SMTP afin de prévenir le spam. Lorsque MAILGUN_API_KEY et MAILGUN_DOMAIN sont tous deux définis, LibreChat utilisera Mailgun au lieu du SMTP.

Configuration SMTP

Configuration de base

Si vous souhaitez utiliser l'un des services prédéfinis, configurez uniquement ces variables : Pour plus d'informations sur les services de messagerie pris en charge : https://community.nodemailer.com/2-0-0-beta/setup-smtp/well-known-services/

Configuration avancée

Si vous souhaitez utiliser un service SMTP générique ou si vous avez besoin d'une configuration avancée pour l'un des fournisseurs prédéfinis, configurez également ces variables :

Configuration avec Mailgun

Pour configurer Mailgun, suivez ces étapes :

1. Inscrivez-vous à un compte Mailgun sur mailgun.com
2. Ajoutez et vérifiez votre domaine dans le tableau de bord Mailgun
3. Accédez à la section API Keys et copiez votre clé API privée.
4. Dans le fichier .env, modifiez les variables comme suit :

Configuration avec Gmail

Pour configurer Gmail, suivez ces étapes :

1. Créez un compte Google et activez la validation en deux étapes.
2. Dans les paramètres de compte Google, cliquez sur l'onglet « Sécurité » et ouvrez la « Validation en deux étapes ».
3. Faites défiler vers le bas et ouvrez « App passwords ». Choisissez « Mail » pour l'application et sélectionnez « Other » pour l'appareil, puis donnez-lui un nom arbitraire.
4. Cliquez sur « Generate » pour créer un mot de passe, puis copiez le mot de passe généré.
5. Dans le fichier .env, modifiez les variables comme suit :

Configuration avec un serveur mail personnalisé

Pour configurer un serveur de messagerie personnalisé, suivez ces étapes :

1. Rassemblez vos données de connexion SMTP auprès de votre fournisseur. Les étapes diffèrent pour chacun, mais ils indiqueront généralement les valeurs pour toutes les variables.
2. Dans le fichier .env, modifiez les variables comme suit, en supposant quelques valeurs d'exemple raisonnables :

Exemples de configuration complets

Exemple 1 : Configuration de Mailgun

# ===================================
# 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

Exemple 2 : Configuration SMTP Gmail

# ===================================
# 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

Exemple 3 : Configuration d'un serveur SMTP personnalisé

# ===================================
# 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

Dépannage

Problèmes avec Mailgun

1. Échec de l'authentification : Assurez-vous que votre clé API Mailgun est correcte et dispose des autorisations d'envoi
2. Domaine introuvable : Vérifiez que votre domaine Mailgun est correctement configuré dans votre compte Mailgun
3. Problèmes liés à la région UE : Si votre compte Mailgun se trouve dans la région UE, assurez-vous de définir MAILGUN_HOST=https://api.eu.mailgun.net
4. Repli vers SMTP : Si une seule des variables MAILGUN_API_KEY ou MAILGUN_DOMAIN est définie, le système utilisera la configuration SMTP par défaut.

Problèmes SMTP

1. Connection Refused : Vérifiez si votre serveur autorise les connexions SMTP sortantes sur le port spécifié
2. Authentication Failed : Vérifiez que votre nom d'utilisateur et votre mot de passe sont corrects
3. Mot de passe d'application Gmail : Pour Gmail, vous devez utiliser un mot de passe spécifique à l'application, et non votre mot de passe habituel.
4. Certificats auto-signés : Si votre serveur de messagerie utilise des certificats auto-signés, définissez EMAIL_ALLOW_SELFSIGNED=true

Problèmes généraux

1. Aucun e-mail envoyé : Vérifiez les journaux de LibreChat pour détecter des messages d'erreur
2. Réinitialisation de mot de passe non sécurisée : Cela se produit lorsque ni Mailgun ni SMTP ne sont correctement configurés
3. Problèmes liés à l'adresse d'expédition : Assurez-vous que l'adresse EMAIL_FROM est valide et autorisée à envoyer des e-mails depuis votre service de messagerie.