Roundcube

Přístup k Roundcube

• Otevřete v prohlížeči následující URL: https://<SERVER_IP>
• Instalace používá vlastnoručně podepsaný TLS certifikát, prohlížeč proto zobrazí bezpečnostní varování. Pokračujte přijetím certifikátu.
• HTTP požadavky na portu 80 jsou automaticky přesměrovány na HTTPS.

Přihlášení

• Roundcube nevytváří ani neukládá poštovní účty.
• Přihlaste se uživatelským jménem a heslem existující schránky na nastaveném IMAP serveru.

Nastavení poštovního serveru

Nastavení připojení k poštovnímu serveru je uloženo v: /root/roundcube/.env

Důležitá nastavení:

• IMAP host: IMAP_HOST
• IMAP port: IMAP_PORT
• SMTP host: SMTP_HOST
• SMTP port: SMTP_PORT
• Doména uživatelského jména: USERNAME_DOMAIN

Výchozí konfigurace používá zástupné hodnoty:

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

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

Nahraďte je skutečným hostname vašeho poštovního serveru.

Po změně nastavení je aplikujte pomocí:

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

Typy TLS připojení

Použijte předponu odpovídající vašemu poštovnímu serveru:

• 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.

Vlastnoručně podepsané certifikáty poštovního serveru

Pokud váš IMAP nebo SMTP server používá vlastnoručně podepsaný certifikát, Roundcube může spojení odmítnout.

Volitelná nastavení ověřování TLS najdete v: /root/roundcube/config/custom.inc.php

Odkomentujte a nastavte příslušné volby připojení IMAP nebo SMTP jen tehdy, když poštovnímu serveru a síti důvěřujete.

Aplikujte konfiguraci:

cd /root/roundcube && docker compose restart roundcube

Pluginy a vzhled

Výchozí instalace zapíná:

• archive
• zipdownload

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

Například:

PLUGINS=archive,zipdownload,managesieve

Aplikujte změny:

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

Bundled plugins such as managesieve, markasjunk, a 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.

Správa Roundcube

Zobrazit stav kontejnerů:

cd /root/roundcube && docker compose ps

Zobrazit logy:

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

Restartovat Roundcube:

cd /root/roundcube && docker compose restart roundcube

Zastavte stack:

cd /root/roundcube && docker compose down

Spusťte stack:

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

Důležité soubory a adresáře

• Cesta k instalaci: /root/roundcube
• Soubor Compose: /root/roundcube/docker-compose.yml
• Soubor prostředí: /root/roundcube/.env
• Další konfigurace: /root/roundcube/config/custom.inc.php
• Svazek databáze: /var/lib/docker/volumes/roundcube_db_data
• Konfigurace Nginx: /etc/nginx/sites-available/roundcube
• Certifikát TLS: /etc/nginx/ssl/roundcube.crt
• Privátní klíč TLS: /etc/nginx/ssl/roundcube.key

Domény a HTTPS

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

2. Nainstalujte 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. Vydejte TLS certifikát:

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

5. Upravte /etc/nginx/sites-available/roundcube a aktualizujte ssl_certificate a ssl_certificate_key direktivy tak, aby používaly váš certifikát Let's Encrypt.

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. Otestujte konfiguraci:

nginx -t

7. Znovu načtěte NGINX:

systemctl reload nginx

8. Otevřete prohlížeč a přejděte na: https://yourdomain.com

Poznámky

• Roundcube is publicly accessible through Nginx on ports 80 a 443.
• The Roundcube container itself listens only on 127.0.0.1:8000.
• MariaDB je interní služba Dockeru a není přímo vystavena hostiteli.
• Výchozí webové rozhraní používá vlastnoručně podepsaný TLS certifikát.
• The upload limit is set to 25 MB; increase both UPLOAD_MAX_FILESIZE and Nginx's client_max_body_size for larger uploads.
• Upravte konfiguraci Roundcube podle svých preferencí.