Configuración de correo electrónico

Para una descripción general rápida, consulte la guía del usuario proporcionada aquí: Restablecimiento de contraseña

Configuración general

LibreChat admite múltiples proveedores de correo electrónico:

• Mailgun API - Recomendado para servidores que bloquean puertos SMTP
• Servicios SMTP - Envío de correo electrónico tradicional a través de Gmail, Outlook o servidores de correo personalizados

Configuración común

Estas variables son utilizadas tanto por Mailgun como por SMTP:

Configuración de Mailgun (Recomendado)

Mailgun es particularmente útil para implementaciones en servidores que bloquean puertos SMTP para prevenir el spam. Cuando tanto MAILGUN_API_KEY como MAILGUN_DOMAIN están configurados, LibreChat utilizará Mailgun en lugar de SMTP.

Configuración de SMTP

Configuración básica

Si desea utilizar uno de los servicios predefinidos, configure solo estas variables: Para obtener más información sobre los servicios de correo electrónico compatibles: https://community.nodemailer.com/2-0-0-beta/setup-smtp/well-known-services/

Configuración avanzada

Si desea utilizar un servicio SMTP genérico o necesita una configuración avanzada para uno de los proveedores predefinidos, configure también estas variables:

Configuración con Mailgun

Para configurar Mailgun, sigue estos pasos:

1. Regístrate para obtener una cuenta de Mailgun en mailgun.com
2. Agregue y verifique su dominio en el panel de control de Mailgun
3. Navegue a la sección API Keys y copie su Private API key
4. En el archivo .env, modifica las variables de la siguiente manera:

Configuración con Gmail

Para configurar Gmail, sigue estos pasos:

1. Cree una cuenta de Google y habilite la verificación en dos pasos.
2. En la Google Account settings, haz clic en la pestaña "Security" y abre "2-step verification."
3. Desplácese hacia abajo y abra "App passwords". Elija "Mail" para la aplicación y seleccione "Other" para el dispositivo, luego asígnele un nombre aleatorio.
4. Haz clic en "Generate" para crear una contraseña y copia la contraseña generada.
5. En el archivo .env, modifica las variables de la siguiente manera:

Configuración con servidor de correo personalizado

Para configurar un servidor de correo personalizado, siga estos pasos:

1. Reúna sus datos de inicio de sesión SMTP de su proveedor. Los pasos son diferentes para cada uno, pero generalmente enumerarán los valores para todas las variables.
2. En el archivo .env, modifica las variables de la siguiente manera, asumiendo algunos valores de ejemplo razonables:

Ejemplos completos de configuración

Ejemplo 1: Configuración 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

Ejemplo 2: Configuración SMTP de 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

Ejemplo 3: Configuración de servidor SMTP personalizado

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

Solución de problemas

Problemas con Mailgun

1. Error de autenticación: Asegúrese de que su clave de API de Mailgun sea correcta y tenga permisos de envío
2. Dominio no encontrado: Verifique que su dominio de Mailgun esté configurado correctamente en su cuenta de Mailgun
3. Problemas con la región de la UE: Si su cuenta de Mailgun se encuentra en la región de la UE, asegúrese de configurar MAILGUN_HOST=https://api.eu.mailgun.net
4. Fallback a SMTP: Si solo se configura MAILGUN_API_KEY o MAILGUN_DOMAIN, el sistema recurrirá a la configuración SMTP.

Problemas con SMTP

1. Connection Refused: Compruebe si su servidor permite conexiones SMTP salientes en el puerto especificado
2. Error de autenticación: Verifique que su nombre de usuario y contraseña sean correctos
3. Contraseña de aplicación de Gmail: Para Gmail, debes usar una contraseña específica de la aplicación, no tu contraseña habitual
4. Certificados autofirmados: Si su servidor de correo utiliza certificados autofirmados, establezca EMAIL_ALLOW_SELFSIGNED=true

Problemas generales

1. No se envían correos electrónicos: Compruebe los registros de LibreChat para ver si hay mensajes de error
2. Restablecimiento de contraseña no seguro: Esto ocurre cuando ni Mailgun ni SMTP están configurados correctamente
3. Problemas con la dirección From: Asegúrese de que la dirección EMAIL_FROM sea válida y esté autorizada para enviar correos desde su servicio de correo.