Configurazione email

Per una rapida panoramica, fare riferimento alla guida utente fornita qui: Password Reset

Configurazione generale

LibreChat supporta diversi provider di posta elettronica:

• Mailgun API - Consigliato per server che bloccano le porte SMTP
• Servizi SMTP - Invio di email tradizionale tramite Gmail, Outlook o server di posta personalizzati

Configurazione comune

Queste variabili sono utilizzate sia da Mailgun che da SMTP:

Configurazione di Mailgun (Consigliata)

Mailgun è particolarmente utile per le distribuzioni su server che bloccano le porte SMTP per prevenire lo spam. Quando sia MAILGUN_API_KEY che MAILGUN_DOMAIN sono impostati, LibreChat utilizzerà Mailgun invece di SMTP.

Configurazione SMTP

Configurazione di base

Se desideri utilizzare uno dei servizi predefiniti, configura solo queste variabili: Per maggiori informazioni sui servizi email supportati: https://nodemailer.com/smtp/well-known-services

Configurazione Avanzata

Se desideri utilizzare un servizio SMTP generico o hai bisogno di una configurazione avanzata per uno dei provider predefiniti, configura anche queste variabili:

Configurazione con Mailgun

Per configurare Mailgun, segui questi passaggi:

1. Registrati per un account Mailgun su mailgun.com
2. Aggiungi e verifica il tuo dominio nella dashboard di Mailgun
3. Vai alla sezione API Keys e copia la tua Private API key
4. Nel file .env, modifica le variabili come segue:

Configurazione con Gmail

Per configurare Gmail, segui questi passaggi:

1. Crea un Google Account e abilita la verifica in due passaggi.
2. Nelle Google Account settings, fai clic sulla scheda "Sicurezza" e apri la "Verifica in due passaggi".
3. Scorri verso il basso e apri "App passwords." Scegli "Mail" per l'app e seleziona "Other" per il dispositivo, quindi assegna un nome a tua scelta.
4. Fai clic su "Generate" per creare una password e copia la password generata.
5. Nel file .env, modifica le variabili come segue:

Configurazione con server di posta personalizzato

Per configurare un server di posta personalizzato, segui questi passaggi:

1. Recupera i tuoi dati di accesso SMTP dal tuo provider. I passaggi variano a seconda del provider, ma solitamente vengono elencati i valori per tutte le variabili.
2. Nel file .env, modifica le variabili come segue, assumendo alcuni valori di esempio ragionevoli:

Esempi di configurazione completi

Esempio 1: Configurazione di 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

Esempio 2: Configurazione SMTP di 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

Esempio 3: Configurazione del server SMTP personalizzato

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

Risoluzione dei problemi

Problemi con Mailgun

1. Autenticazione fallita: Assicurati che la tua chiave API Mailgun sia corretta e disponga delle autorizzazioni di invio
2. Dominio non trovato: Verifica che il tuo dominio Mailgun sia configurato correttamente nel tuo account Mailgun
3. Problemi con la regione UE: Se il tuo account Mailgun si trova nella regione UE, assicurati di impostare MAILGUN_HOST=https://api.eu.mailgun.net
4. Fallback a SMTP: Se solo uno tra MAILGUN_API_KEY o MAILGUN_DOMAIN è impostato, il sistema passerà alla configurazione SMTP

Problemi SMTP

1. Connection Refused: Controlla se il tuo server consente connessioni SMTP in uscita sulla porta specificata
2. Autenticazione fallita: Verifica che il tuo nome utente e la tua password siano corretti
3. Password dell'app Gmail: Per Gmail, devi utilizzare una password specifica per l'app, non la tua password abituale
4. Certificati autofirmati: Se il tuo server di posta utilizza certificati autofirmati, imposta EMAIL_ALLOW_SELFSIGNED=true

Problemi generali

1. Nessuna email inviata: Controlla i log di LibreChat per eventuali messaggi di errore
2. Ripristino password non protetto: Si verifica quando né Mailgun né SMTP sono configurati correttamente
3. Problemi con l'indirizzo mittente: Assicurati che l'indirizzo EMAIL_FROM sia valido e autorizzato all'invio dal tuo servizio di posta.