Pengaturan email

Panduan ini menjelaskan cara mengonfigurasi verifikasi email/atur ulang kata sandi yang aman. Anda dapat mengonfigurasinya agar berfungsi dengan berbagai layanan email, termasuk Gmail, Mailgun, dan server email kustom.

Untuk gambaran umum yang cepat, silakan merujuk ke panduan pengguna yang disediakan di sini: Password Reset

Pengaturan umum

LibreChat mendukung beberapa penyedia email:

Mailgun API - Direkomendasikan untuk server yang memblokir port SMTP
Layanan SMTP - Pengiriman email tradisional melalui Gmail, Outlook, atau server email kustom

Konfigurasi Umum

Variabel-variabel ini digunakan oleh Mailgun maupun SMTP:

Key	Type	Description	Example
EMAIL_FROM	string	Alamat email pengirim. Wajib diisi.	[email protected]
EMAIL_FROM_NAME	string	Nama pengirim (default ke APP_TITLE jika tidak diatur).	EMAIL_FROM_NAME=LibreChat

Konfigurasi Mailgun (Direkomendasikan)

Mailgun sangat berguna untuk penerapan di server yang memblokir port SMTP guna mencegah spam. Ketika MAILGUN_API_KEY dan MAILGUN_DOMAIN keduanya diatur, LibreChat akan menggunakan Mailgun alih-alih SMTP.

Key	Type	Description	Example
MAILGUN_API_KEY	string	Kunci API Mailgun Anda (diperlukan untuk Mailgun).	MAILGUN_API_KEY=
MAILGUN_DOMAIN	string	Domain Mailgun Anda, contoh: mg.yourdomain.com (diperlukan untuk Mailgun).	MAILGUN_DOMAIN=
MAILGUN_HOST	string	Host API Mailgun kustom (opsional). Gunakan https://api.eu.mailgun.net untuk wilayah UE.	MAILGUN_HOST=https://api.mailgun.net

Konfigurasi SMTP

Konfigurasi Dasar

Jika Anda ingin menggunakan salah satu layanan yang telah ditentukan sebelumnya, konfigurasikan variabel-variabel ini saja: Untuk informasi lebih lanjut mengenai layanan email yang didukung: https://nodemailer.com/smtp/well-known-services

Key	Type	Description	Example
EMAIL_SERVICE	string	Layanan email (contoh: Gmail, Outlook).	EMAIL_SERVICE=
EMAIL_USERNAME	string	Nama pengguna untuk autentikasi.	EMAIL_USERNAME=
EMAIL_PASSWORD	string	Kata sandi untuk autentikasi.	EMAIL_PASSWORD=

Konfigurasi Lanjutan

Jika Anda ingin menggunakan layanan SMTP generik atau memerlukan konfigurasi tingkat lanjut untuk salah satu penyedia yang telah ditentukan sebelumnya, konfigurasikan juga variabel-variabel berikut:

Key	Type	Description	Example
EMAIL_HOST	string	Host server email.	EMAIL_HOST=
EMAIL_PORT	number	Port server email.	EMAIL_PORT=25
EMAIL_ENCRYPTION	string	Metode enkripsi (starttls, tls, dll.).	EMAIL_ENCRYPTION=
EMAIL_ENCRYPTION_HOSTNAME	string	Hostname untuk enkripsi.	EMAIL_ENCRYPTION_HOSTNAME=
EMAIL_ALLOW_SELFSIGNED	boolean	Izinkan sertifikat yang ditandatangani sendiri (self-signed).	EMAIL_ALLOW_SELFSIGNED=

Peringatan

Gagal mengonfigurasi Mailgun atau SMTP dengan benar akan menyebabkan LibreChat menggunakan pengaturan ulang kata sandi yang tidak aman! Hal ini memungkinkan siapa saja untuk mengatur ulang kata sandi apa pun di server Anda secara langsung, tanpa ada email yang dikirim sama sekali!

Pengaturan dengan Mailgun

Untuk mengatur Mailgun, ikuti langkah-langkah berikut:

Daftarkan akun Mailgun di mailgun.com
Tambahkan dan verifikasi domain Anda di dasbor Mailgun
Buka bagian API Keys dan salin Private API key Anda
Di dalam file .env, ubah variabel-variabel tersebut sebagai berikut:

Key	Type	Description	Example
MAILGUN_API_KEY	string	Kunci API pribadi Mailgun Anda	MAILGUN_API_KEY=your-mailgun-api-key
MAILGUN_DOMAIN	string	Domain Mailgun Anda yang terverifikasi	MAILGUN_DOMAIN=mg.yourdomain.com
EMAIL_FROM	string	Alamat email pengirim	[email protected]
EMAIL_FROM_NAME	string	Nama pengirim	EMAIL_FROM_NAME=LibreChat
MAILGUN_HOST	string	(Opsional) Untuk wilayah UE	MAILGUN_HOST=https://api.eu.mailgun.net

Catatan

Jika akun Mailgun Anda berada di wilayah EU, pastikan untuk mengatur MAILGUN_HOST=https://api.eu.mailgun.net

Setup dengan Gmail

Untuk mengatur Gmail, ikuti langkah-langkah berikut:

Buat Akun Google dan aktifkan verifikasi 2 langkah.
Di dalam Google Account settings, klik tab "Security" dan buka "2-step verification."
Gulir ke bawah dan buka "App passwords." Pilih "Mail" untuk aplikasi dan pilih "Other" untuk perangkat, lalu berikan nama acak.
Klik "Generate" untuk membuat kata sandi, lalu salin kata sandi yang telah dibuat.
Di dalam file .env, ubah variabel-variabel tersebut sebagai berikut:

Key	Type	Description	Example
EMAIL_SERVICE	string	gmail	EMAIL_SERVICE=gmail
EMAIL_USERNAME	string	email-anda	EMAIL_USERNAME=your-email
EMAIL_PASSWORD	string	kata-sandi-email-anda	EMAIL_PASSWORD=your-email-password
EMAIL_FROM	string	alamat email untuk kolom from, contohnya [email protected]	[email protected]
EMAIL_FROM_NAME	string	Server LibreChat Saya	EMAIL_FROM_NAME=LibreChat

Pengaturan dengan mail server kustom

Untuk mengatur server email kustom, ikuti langkah-langkah berikut:

Kumpulkan data login SMTP Anda dari penyedia layanan Anda. Langkah-langkahnya berbeda untuk setiap penyedia, tetapi biasanya mereka akan mencantumkan nilai untuk semua variabel.
Di dalam file .env, ubah variabel-variabel tersebut sebagai berikut, dengan mengasumsikan beberapa nilai contoh yang masuk akal:

Key	Type	Description	Example
EMAIL_HOST	string	Nama host untuk dihubungkan	EMAIL_HOST=mail.example.com
EMAIL_PORT	integer	Port untuk dihubungkan	EMAIL_PORT=25
EMAIL_ENCRYPTION	string	Tipe enkripsi	EMAIL_ENCRYPTION=starttls
EMAIL_USERNAME	string	Nama pengguna email Anda	[email protected]
EMAIL_PASSWORD	string	Kata sandi aplikasi Anda	EMAIL_PASSWORD=password
EMAIL_FROM	string	Alamat email untuk kolom pengirim	[email protected]
EMAIL_FROM_NAME	string	Nama yang akan muncul di kolom "from"	EMAIL_FROM_NAME=LibreChat

Contoh Konfigurasi Lengkap

Contoh 1: Konfigurasi 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

Contoh 2: Konfigurasi 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

Contoh 3: Konfigurasi Server SMTP Kustom

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

Pemecahan Masalah

Masalah Mailgun

Autentikasi Gagal: Pastikan kunci API Mailgun Anda sudah benar dan memiliki izin pengiriman
Domain Tidak Ditemukan: Pastikan domain Mailgun Anda telah dikonfigurasi dengan benar di akun Mailgun Anda
Masalah Wilayah EU: Jika akun Mailgun Anda berada di wilayah EU, pastikan untuk mengatur MAILGUN_HOST=https://api.eu.mailgun.net
Fallback ke SMTP: Jika hanya salah satu dari MAILGUN_API_KEY atau MAILGUN_DOMAIN yang diatur, sistem akan beralih (fallback) ke konfigurasi SMTP

Masalah SMTP

Connection Refused: Periksa apakah server Anda mengizinkan koneksi SMTP keluar pada port yang ditentukan
Autentikasi Gagal: Pastikan nama pengguna dan kata sandi Anda sudah benar
Gmail App Password: Untuk Gmail, Anda harus menggunakan kata sandi khusus aplikasi, bukan kata sandi biasa Anda
Sertifikat yang ditandatangani sendiri (Self-signed Certificates): Jika server email Anda menggunakan sertifikat yang ditandatangani sendiri, atur EMAIL_ALLOW_SELFSIGNED=true

Masalah Umum

Email Tidak Terkirim: Periksa log LibreChat untuk pesan kesalahan
Reset Kata Sandi Tidak Aman: Ini terjadi ketika Mailgun maupun SMTP tidak dikonfigurasi dengan benar
Masalah Alamat Pengirim: Pastikan alamat EMAIL_FROM valid dan diotorisasi untuk mengirim dari layanan surel Anda

Pengaturan email

Di halaman ini