Panduan Konfigurasi Layanan Mailpit di ServBay

ServBay telah mengintegrasikan paket perangkat lunak Mailpit, menyediakan server email lokal yang praktis untuk developer dalam menguji dan melakukan debugging fitur pengiriman email pada aplikasi. Dokumen ini menjelaskan secara detail cara memasang, mengaktifkan, dan mengonfigurasi paket Mailpit di ServBay, termasuk empat tab konfigurasi utama: Common, SMTP, POP3, dan Relay.

Gambaran Umum Mailpit

Mailpit adalah alat open-source yang menawarkan server SMTP/POP3 lokal yang mudah digunakan, lengkap dengan antarmuka web yang intuitif. Alat ini dapat menangkap seluruh email yang dikirim oleh aplikasi Anda sehingga Anda dapat memeriksa isi, header, dan lampiran email secara terpusat tanpa mengirimkan email uji ke kotak masuk asli. Hal ini sangat menyederhanakan proses pengembangan dan debugging, terutama ketika menangani fitur pendaftaran pengguna, reset kata sandi, notifikasi, dan lain-lain yang melibatkan pengiriman email.

Di ServBay, Mailpit diintegrasikan sebagai paket inti yang dapat Anda pasang dan kelola dengan mudah. Anda juga dapat memanfaatkan sistem PKI (Public Key Infrastructure) ServBay untuk konfigurasi SSL/TLS otomatis, memastikan lingkungan pengujian yang aman.

Memasang dan Mengaktifkan Paket Mailpit

Sebelum menggunakan Mailpit sebagai server email lokal, Anda perlu memasang dan mengaktifkan paket Mailpit di ServBay.

1. Buka aplikasi ServBay.
2. Pada sidebar kiri, pilih Paket.
3. Cari kategori Layanan Umum pada daftar paket.
4. Temukan paket Mailpit.
5. Jika Mailpit belum terpasang, klik tombol hijau Install di sebelah kanannya.
6. Setelah instalasi selesai, klik tombol switch untuk mengaktifkan paket Mailpit.

Berkat sistem PKI canggih pada ServBay, ServBay akan secara otomatis menghasilkan dan mengonfigurasi sertifikat SSL yang dibutuhkan untuk antarmuka manajemen web Mailpit serta layanan SMTP dan POP3. Artinya, Anda dapat langsung mengaktifkan enkripsi STARTTLS atau SSL/TLS tanpa harus mengajukan atau mengonfigurasi sertifikat secara manual.

Antarmuka Web Manajemen Email

Mailpit dilengkapi dengan antarmuka web yang kuat untuk melihat dan mengelola email yang ditangkap. ServBay telah mengonfigurasi antarmuka ini secara otomatis, sehingga begitu paket Mailpit aktif, Anda dapat mengaksesnya lewat browser:

Alamat akses: https://mail.servbay.host

Melalui antarmuka ini, Anda dapat dengan mudah menelusuri daftar email masuk, melihat detail email (termasuk HTML, teks polos, dan source), melakukan pencarian email, menghapus email, dan sebagainya.

Konfigurasi Paket Mailpit

ServBay menyediakan antarmuka grafis untuk mengonfigurasi berbagai parameter Mailpit. Pada sidebar kiri ServBay, pilih Mail, lalu klik Mailpit Service Config untuk masuk ke halaman konfigurasi. Anda akan menemukan empat tab utama: Common, SMTP, POP3, dan Relay.

1. Tab Common

Tab Common digunakan untuk mengatur parameter umum dan perilaku dasar Mailpit:

• Max Messages: Tetapkan jumlah maksimum email yang dapat disimpan server Mailpit. Jika jumlah email melampaui batas ini, email tertua akan dihapus otomatis.
• Max Age: Atur durasi maksimal (dalam hari) email disimpan di server Mailpit. Email yang melebihi durasi ini akan dihapus secara otomatis.
• SpamAssassin: Aktifkan atau nonaktifkan fitur filter spam SpamAssassin. Jika aktif, Mailpit akan mencoba menandai email yang masuk sebagai spam.
• Webhook URL: Konfigurasi Webhook URL yang akan menerima notifikasi (HTTP POST) setiap kali ada email baru masuk ke Mailpit. Fitur ini bermanfaat untuk integrasi dengan automation testing atau sistem notifikasi eksternal.
• Webhook Limit: Batasi jumlah email dalam notifikasi Webhook.

2. Tab SMTP

TIP

Berkat sistem PKI canggih, ServBay sudah secara default menghasilkan dan mengonfigurasi sertifikat SSL. Anda dapat langsung mengaktifkan koneksi terenkripsi STARTTLS atau SSL/TLS tanpa perlu menyiapkan sertifikat SSL tambahan.

Tab SMTP digunakan untuk mengatur parameter server SMTP Mailpit. Aplikasi Anda akan terhubung ke server SMTP ini untuk mengirim email uji:

• SMTP Port: Tentukan port yang digunakan server SMTP Mailpit. Set aplikasi Anda agar mengirim email ke 127.0.0.1 atau localhost pada port ini. Default: 1025.
• STARTTLS: Aktifkan atau nonaktifkan enkripsi STARTTLS, memungkinkan koneksi bertransisi ke komunikasi terenkripsi setelah tersambung.
• SSL/TLS: Aktifkan atau nonaktifkan enkripsi SSL/TLS, di mana komunikasi dienkripsi sejak awal koneksi.
• Username: Atur username untuk server SMTP (opsional). Jika disetel, aplikasi Anda wajib melakukan autentikasi menggunakan username ini saat mengirim email.
• Password: Atur password untuk server SMTP (opsional), digunakan bersama Username saat autentikasi.
• Max Recipients: Tetapkan jumlah maksimum penerima dalam satu email untuk mencegah satu email dikirim ke terlalu banyak alamat.
• Allowed Recipients: Daftar alamat email atau domain yang diperbolehkan menerima email (opsional). Jika dikosongkan, Mailpit akan menerima email untuk alamat mana pun. Jika diisi, hanya email ke alamat/domain yang terdapat di daftar ini yang akan diterima.

3. Tab POP3

TIP

Berkat sistem PKI canggih, ServBay sudah secara default menghasilkan dan mengonfigurasi sertifikat SSL. Anda dapat langsung mengaktifkan koneksi terenkripsi SSL/TLS tanpa perlu menyiapkan sertifikat SSL tambahan.

Tab POP3 digunakan untuk mengonfigurasi server POP3 Mailpit. Jika Anda perlu menguji fitur penerimaan email pada aplikasi, atur klien email untuk terhubung ke server ini:

• Enable POP3 Server: Aktifkan atau nonaktifkan layanan server POP3 Mailpit.
• POP3 Server Port: Tentukan port server POP3 Mailpit. Default: 1110.
• Username: Atur username untuk server POP3 (opsional). Jika diisi, klien harus melakukan autentikasi menggunakan username ini saat login.
• Password: Atur password untuk server POP3 (opsional), digunakan bersama Username saat autentikasi.
• SSL/TLS: Aktifkan atau nonaktifkan koneksi terenkripsi SSL/TLS.

4. Tab Relay

Tab Relay digunakan untuk mengonfigurasi fitur penerusan (relay) email Mailpit. Anda dapat menyetel Mailpit sebagai relay agar email tertentu atau seluruh email yang ditangkap diteruskan ke server SMTP eksternal yang sesungguhnya:

• Enable SMTP Relay: Aktifkan atau nonaktifkan fitur SMTP relay.
• Host: Alamat server SMTP eksternal sebagai tujuan relay (misal: smtp.gmail.com, smtp.sendgrid.net).
• Port: Nomor port server SMTP eksternal. Default: 25 (SMTP standar), 465 (SMTPS), atau 587 (Submission).
• STARTTLS: Aktifkan atau nonaktifkan koneksi terenkripsi STARTTLS ke server relay.
• Allow Insecure: Izinkan koneksi ke server SMTP relay dengan sertifikat tidak terpercaya (tidak disarankan untuk produksi).
• Auth: Pilih metode autentikasi ke server relay. Opsi umum: Login (mengirim username & password), Plain (mirip Login), atau CRAM-MD5 (autentikasi berdasarkan challenge/response).
• Username: Username untuk koneksi ke server SMTP relay.
• Password: Password untuk koneksi ke server SMTP relay.
• Return Path: Alamat pengembalian (Return-Path) untuk email yang diteruskan.
• Allowed Recipients: Daftar alamat/down yang diizinkan sebagai penerima relay (opsional).
• Blocked Recipients: Daftar alamat/down yang diblokir agar tidak di-relay (opsional).
• Relay All: Jika dicentang, Mailpit akan mencoba meneruskan seluruh email yang ditangkap (terbatas Allowed/Blocked Recipients).
• Relay Matching: Jika dicentang, hanya email yang cocok dengan aturan Allowed Recipients atau Blocked Recipients yang akan di-relay.

Menyimpan Konfigurasi

Setiap kali Anda mengubah konfigurasi Mailpit, pastikan untuk mengklik tombol Save di bagian bawah antarmuka agar perubahan tersimpan.

Klik tombol Reset untuk mengembalikan seluruh pengaturan ke konfigurasi default Mailpit.

Tanya Jawab (FAQ)

• T: Mengapa email yang dikirim aplikasi saya tidak muncul di Mailpit?
  • J: Periksa pengaturan SMTP pada aplikasi Anda, pastikan host dan port sudah diarahkan ke alamat Mailpit di ServBay (127.0.0.1 atau localhost) dan port SMTP yang dikonfigurasi di Mailpit (default: 1025). Pastikan juga paket Mailpit telah aktif dan berjalan di ServBay. Anda dapat mengecek statusnya pada daftar paket ServBay.
• T: Apakah saya perlu mengonfigurasi sertifikat SSL untuk Mailpit?
  • J: Tidak perlu. Dengan adanya sistem PKI ServBay, sertifikat yang dibutuhkan untuk antarmuka web, SMTP, dan POP3 Mailpit akan dihasilkan dan dikonfigurasi secara otomatis untuk STARTTLS/SSL/TLS. Anda hanya perlu mengaktifkan opsi enkripsi di tab konfigurasi terkait.
• T: Apa username dan password default untuk antarmuka web Mailpit?
  • J: Secara default, antarmuka web Mailpit yang dapat diakses dari https://mail.servbay.host tidak membutuhkan username atau password. Layanan SMTP dan POP3 Mailpit pun secara default tidak memerlukan autentikasi. Jika Anda ingin mewajibkan autentikasi pada SMTP atau POP3, silakan atur username dan password pada tab konfigurasi terkait.

Kesimpulan

Dengan integrasi Mailpit di ServBay, Anda dapat dengan mudah membangun lingkungan pengujian email lokal. Atur SMTP, POP3, dan Relay Mailpit sesuai kebutuhan, dan manfaatkan antarmuka web yang intuitif untuk meningkatkan efisiensi pengembangan dan pengujian fitur email pada aplikasi Anda.

Perlu diperhatikan, setelah perubahan konfigurasi, mungkin Anda perlu me-restart paket Mailpit agar konfigurasi baru berlaku. Anda dapat melakukannya melalui antarmuka manajemen paket ServBay—cari Mailpit lalu klik tombol restart.