Roundcube

Mengakses Roundcube

• Buka URL berikut di browser Anda: https://<SERVER_IP>
• Instalasi memakai sertifikat TLS yang ditandatangani sendiri, sehingga peramban akan menampilkan peringatan keamanan. Terima sertifikat itu untuk melanjutkan.
• Permintaan HTTP di porta 80 dialihkan otomatis ke HTTPS.

Masuk

• Roundcube tidak membuat atau menyimpan akun kotak surat.
• Masuk dengan nama pengguna dan kata sandi kotak surat yang sudah ada di server IMAP yang Anda konfigurasi.

Mengonfigurasi server surel Anda

Pengaturan koneksi server surel disimpan di: /root/roundcube/.env

Pengaturan penting:

• Host IMAP: IMAP_HOST
• Porta IMAP: IMAP_PORT
• Host SMTP: SMTP_HOST
• Porta SMTP: SMTP_PORT
• Domain nama pengguna: USERNAME_DOMAIN

Konfigurasi bawaan memakai nilai placeholder:

IMAP_HOST=ssl://mail.example.org
IMAP_PORT=993

SMTP_HOST=tls://mail.example.org
SMTP_PORT=587

Ganti nilai tersebut dengan nama host server surel Anda yang sebenarnya.

Setelah mengubah pengaturan, terapkan dengan:

cd /root/roundcube && docker compose up -d

Jenis koneksi TLS

Gunakan awalan yang sesuai untuk server surel Anda:

• ssl://: Implicit TLS, typically used with IMAP port 993 or SMTP port 465.
• tls://: STARTTLS, typically used with IMAP port 143 or SMTP port 587.

Sertifikat server surel yang ditandatangani sendiri

Jika server IMAP atau SMTP Anda memakai sertifikat yang ditandatangani sendiri, Roundcube bisa menolak koneksi.

Pengaturan verifikasi TLS opsional berada di: /root/roundcube/config/custom.inc.php

Hapus tanda komentar dan konfigurasikan opsi koneksi IMAP atau SMTP terkait hanya jika Anda memercayai server surel dan jaringannya.

Terapkan konfigurasi:

cd /root/roundcube && docker compose restart roundcube

Plugin dan skin

Instalasi bawaan mengaktifkan:

• archive
• zipdownload

Plugins are configured through the PLUGINS variable in: /root/roundcube/.env

Sebagai contoh:

PLUGINS=archive,zipdownload,managesieve

Terapkan perubahan:

cd /root/roundcube && docker compose up -d

Bundled plugins such as managesieve, markasjunk, dan enigma can be enabled by adding them to PLUGINS, when supported by the image.

For third-party plugins, add them to ROUNDCUBEMAIL_COMPOSER_PLUGINS in the Compose file and include their names in PLUGINS.

Mengelola Roundcube

Melihat status kontainer:

cd /root/roundcube && docker compose ps

Lihat log:

cd /root/roundcube && docker compose logs -f

Mulai ulang Roundcube:

cd /root/roundcube && docker compose restart roundcube

Hentikan stack:

cd /root/roundcube && docker compose down

Mulai stack:

cd /root/roundcube && docker compose up -d

File dan Direktori Penting

• Jalur instalasi: /root/roundcube
• File Compose: /root/roundcube/docker-compose.yml
• File Lingkungan: /root/roundcube/.env
• Konfigurasi tambahan: /root/roundcube/config/custom.inc.php
• Volume Database: /var/lib/docker/volumes/roundcube_db_data
• Konfigurasi Nginx: /etc/nginx/sites-available/roundcube
• Sertifikat TLS: /etc/nginx/ssl/roundcube.crt
• Kunci Privat TLS: /etc/nginx/ssl/roundcube.key

Domain & HTTPS

1. Point your domain to the server's IP address (e.g., yourdomain.com;).

2. Instal Certbot:

apt update
apt install -y certbot python3-certbot-nginx

3. Edit NGINX config and replace both server_name _; entries with your domain (e.g., server_name yourdomain.com;):

vim /etc/nginx/sites-available/roundcube

4. Terbitkan sertifikat TLS:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Edit /etc/nginx/sites-available/roundcube dan perbarui ssl_certificate dan ssl_certificate_key direktif agar menggunakan sertifikat Let's Encrypt Anda.

Before:
    ssl_certificate     /etc/nginx/ssl/roundcube.crt;
    ssl_certificate_key /etc/nginx/ssl/roundcube.key;
After:
    ssl_certificate  /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. Uji konfigurasinya:

nginx -t

7. Muat ulang NGINX:

systemctl reload nginx

8. Buka browser dan kunjungi: https://yourdomain.com

Catatan

• Roundcube is publicly accessible through Nginx on ports 80 dan 443.
• The Roundcube container itself listens only on 127.0.0.1:8000.
• MariaDB adalah layanan internal Docker dan tidak dibuka langsung ke host.
• Antarmuka web bawaan memakai sertifikat TLS yang ditandatangani sendiri.
• The upload limit is set to 25 MB; increase both UPLOAD_MAX_FILESIZE and Nginx's client_max_body_size for larger uploads.
• Ubah konfigurasi Roundcube sesuai preferensi Anda.