E-mailinstellingen

Voor een snel overzicht, raadpleeg de gebruikershandleiding die hier wordt verstrekt: Wachtwoord opnieuw instellen

Algemene configuratie

LibreChat ondersteunt meerdere e-mailproviders:

• Mailgun API - Aanbevolen voor servers die SMTP-poorten blokkeren
• SMTP-services - Traditionele e-mailverzending via Gmail, Outlook of aangepaste mailservers

Algemene configuratie

Deze variabelen worden gebruikt door zowel Mailgun als SMTP:

Mailgun Configuratie (Aanbevolen)

Mailgun is bijzonder nuttig voor implementaties op servers die SMTP-poorten blokkeren om spam te voorkomen. Wanneer zowel MAILGUN_API_KEY als MAILGUN_DOMAIN zijn ingesteld, zal LibreChat Mailgun gebruiken in plaats van SMTP.

SMTP-configuratie

Basisconfiguratie

Als je een van de vooraf gedefinieerde services wilt gebruiken, configureer dan alleen deze variabelen: Voor meer informatie over ondersteunde e-mailservices: https://nodemailer.com/smtp/well-known-services

Geavanceerde configuratie

Als je een generieke SMTP-service wilt gebruiken of geavanceerde configuratie nodig hebt voor een van de vooraf gedefinieerde providers, configureer dan ook deze variabelen:

Setup met Mailgun

Volg deze stappen om Mailgun in te stellen:

1. Meld je aan voor een Mailgun-account op mailgun.com
2. Voeg je domein toe en verifieer het in het Mailgun-dashboard
3. Navigeer naar de sectie API Keys en kopieer je Private API key
4. Wijzig de variabelen in het .env bestand als volgt:

Instellen met Gmail

Volg deze stappen om Gmail in te stellen:

1. Maak een Google-account aan en schakel 2-stapsverificatie in.
2. Klik in de Google Account settings op het tabblad "Beveiliging" en open "Tweestapsverificatie."
3. Scroll naar beneden en open "App passwords." Kies "Mail" voor de app en selecteer "Other" voor het apparaat, geef het vervolgens een willekeurige naam.
4. Klik op "Generate" om een wachtwoord aan te maken en kopieer het gegenereerde wachtwoord.
5. Wijzig de variabelen in het .env bestand als volgt:

Instellen met een aangepaste mailserver

Volg deze stappen om een aangepaste mailserver in te stellen:

1. Verzamel je SMTP-inloggegevens van je provider. De stappen verschillen per provider, maar meestal worden de waarden voor alle variabelen vermeld.
2. Wijzig in het .env bestand de variabelen als volgt, uitgaande van enkele logische voorbeeldwaarden:

Volledige configuratievoorbeelden

Voorbeeld 1: Mailgun-configuratie

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

Voorbeeld 2: Gmail SMTP-configuratie

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

Voorbeeld 3: Aangepaste SMTP-serverconfiguratie

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

Probleemoplossing

Mailgun problemen

1. Authenticatie mislukt: Zorg ervoor dat uw Mailgun API-sleutel correct is en over verzendrechten beschikt
2. Domein niet gevonden: Controleer of uw Mailgun-domein correct is geconfigureerd in uw Mailgun-account
3. EU-regio problemen: Als uw Mailgun-account zich in de EU-regio bevindt, zorg er dan voor dat u MAILGUN_HOST=https://api.eu.mailgun.net instelt.
4. Terugvallen op SMTP: Als slechts één van MAILGUN_API_KEY of MAILGUN_DOMAIN is ingesteld, zal het systeem terugvallen op de SMTP-configuratie

SMTP-problemen

1. Connection Refused: Controleer of uw server uitgaande SMTP-verbindingen op de opgegeven poort toestaat
2. Authenticatie mislukt: Controleer of uw gebruikersnaam en wachtwoord correct zijn
3. Gmail App Password: Voor Gmail moet je een app-specifiek wachtwoord gebruiken, niet je normale wachtwoord
4. Zelfondertekende certificaten: Als uw mailserver gebruikmaakt van zelfondertekende certificaten, stel dan EMAIL_ALLOW_SELFSIGNED=true in.

Algemene problemen

1. Geen e-mails verzonden: Controleer de LibreChat logs op foutmeldingen
2. Onbeveiligde wachtwoordreset: Dit gebeurt wanneer noch Mailgun, noch SMTP correct is geconfigureerd
3. Problemen met het 'Van'-adres: Zorg ervoor dat het EMAIL_FROM-adres geldig is en geautoriseerd is om te verzenden via uw e-mailservice