Configuração de e-mail

Para uma visão geral rápida, consulte o guia do usuário fornecido aqui: Password Reset

Configuração geral

O LibreChat oferece suporte a vários provedores de e-mail:

• Mailgun API - Recomendado para servidores que bloqueiam portas SMTP
• Serviços SMTP - Envio de e-mail tradicional via Gmail, Outlook ou servidores de e-mail personalizados

Configuração Comum

Estas variáveis são usadas tanto pelo Mailgun quanto pelo SMTP:

Configuração do Mailgun (Recomendado)

O Mailgun é particularmente útil para implantações em servidores que bloqueiam portas SMTP para evitar spam. Quando MAILGUN_API_KEY e MAILGUN_DOMAIN estão definidos, o LibreChat usará o Mailgun em vez de SMTP.

Configuração de SMTP

Configuração Básica

Se você quiser usar um dos serviços predefinidos, configure apenas estas variáveis: Para mais informações sobre serviços de e-mail suportados: https://nodemailer.com/smtp/well-known-services

Configuração Avançada

Se você deseja usar um serviço SMTP genérico ou precisa de uma configuração avançada para um dos provedores predefinidos, configure estas variáveis também:

Configuração com Mailgun

Para configurar o Mailgun, siga estas etapas:

1. Crie uma conta no Mailgun em mailgun.com
2. Adicione e verifique seu domínio no painel do Mailgun
3. Navegue até a seção API Keys e copie sua chave de API privada (Private API key)
4. No arquivo .env, modifique as variáveis da seguinte forma:

Configuração com Gmail

Para configurar o Gmail, siga estas etapas:

1. Crie uma Conta Google e ative a verificação em duas etapas.
2. Nas Google Account settings, clique na aba "Segurança" e abra a "Verificação em duas etapas".
3. Role para baixo e abra "App passwords." Escolha "Mail" para o aplicativo e selecione "Other" para o dispositivo, então dê a ele um nome qualquer.
4. Clique em "Generate" para criar uma senha e copie a senha gerada.
5. No arquivo .env, modifique as variáveis da seguinte forma:

Configuração com servidor de e-mail personalizado

Para configurar um servidor de e-mail personalizado, siga estas etapas:

1. Reúna seus dados de login SMTP do seu provedor. As etapas são diferentes para cada um, mas eles geralmente listarão os valores para todas as variáveis.
2. No arquivo .env, modifique as variáveis da seguinte forma, assumindo alguns valores de exemplo sensatos:

Exemplos Completos de Configuração

Exemplo 1: Configuração do 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

Exemplo 2: Configuração de SMTP do 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

Exemplo 3: Configuração 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

Solução de problemas

Problemas com o Mailgun

1. Falha na autenticação: Certifique-se de que sua chave de API do Mailgun esteja correta e possua permissões de envio
2. Domínio não encontrado: Verifique se o seu domínio Mailgun está configurado corretamente na sua conta Mailgun
3. Problemas com a região da UE: Se sua conta Mailgun estiver na região da UE, certifique-se de definir MAILGUN_HOST=https://api.eu.mailgun.net
4. Fallback para SMTP: Se apenas uma das variáveis MAILGUN_API_KEY ou MAILGUN_DOMAIN estiver definida, o sistema fará o fallback para a configuração de SMTP.

Problemas com SMTP

1. Connection Refused: Verifique se o seu servidor permite conexões SMTP de saída na porta especificada
2. Falha na Autenticação: Verifique se seu nome de usuário e senha estão corretos
3. Senha de aplicativo do Gmail: Para o Gmail, você deve usar uma senha específica de aplicativo, não a sua senha comum.
4. Certificados autoassinados: Se o seu servidor de e-mail utiliza certificados autoassinados, defina EMAIL_ALLOW_SELFSIGNED=true

Problemas Gerais

1. Nenhum e-mail enviado: Verifique os logs do LibreChat para mensagens de erro
2. Redefinição de senha não segura: Isso ocorre quando nem o Mailgun nem o SMTP estão configurados corretamente
3. Problemas com o endereço "From": Certifique-se de que o endereço EMAIL_FROM seja válido e esteja autorizado a enviar e-mails pelo seu serviço de e-mail.