Roundcube

Dostęp do Roundcube

• Otwórz poniższy URL w przeglądarce: https://<SERVER_IP>
• Instalacja używa samopodpisanego certyfikatu TLS, więc przeglądarka wyświetli ostrzeżenie o zabezpieczeniach. Zaakceptuj certyfikat, aby kontynuować.
• Żądania HTTP na porcie 80 są automatycznie przekierowywane na HTTPS.

Logowanie

• Roundcube nie tworzy ani nie przechowuje kont pocztowych.
• Zaloguj się nazwą użytkownika i hasłem istniejącej skrzynki na skonfigurowanym serwerze IMAP.

Konfiguracja serwera pocztowego

Ustawienia połączenia z serwerem pocztowym są zapisane w: /root/roundcube/.env

Ważne ustawienia:

• Host IMAP: IMAP_HOST
• Port IMAP: IMAP_PORT
• Host SMTP: SMTP_HOST
• Port SMTP: SMTP_PORT
• Domena nazwy użytkownika: USERNAME_DOMAIN

Domyślna konfiguracja zawiera wartości zastępcze:

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

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

Zastąp je rzeczywistą nazwą hosta swojego serwera pocztowego.

Po zmianie ustawień zastosuj je poleceniem:

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

Typy połączeń TLS

Użyj przedrostka odpowiedniego dla swojego serwera pocztowego:

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

Samopodpisane certyfikaty serwera pocztowego

Jeśli Twój serwer IMAP lub SMTP używa samopodpisanego certyfikatu, Roundcube może odrzucić połączenie.

Opcjonalne ustawienia weryfikacji TLS znajdują się w: /root/roundcube/config/custom.inc.php

Odkomentuj i skonfiguruj odpowiednie opcje połączenia IMAP lub SMTP tylko wtedy, gdy ufasz serwerowi pocztowemu i sieci.

Zastosuj konfigurację:

cd /root/roundcube && docker compose restart roundcube

Wtyczki i skórka

Domyślna instalacja włącza:

• archive
• zipdownload

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

Na przykład:

PLUGINS=archive,zipdownload,managesieve

Zastosuj zmiany:

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

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

Zarządzanie Roundcube

Sprawdź stan kontenerów:

cd /root/roundcube && docker compose ps

Zobacz logi:

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

Zrestartuj Roundcube:

cd /root/roundcube && docker compose restart roundcube

Zatrzymaj stos:

cd /root/roundcube && docker compose down

Uruchom stos:

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

Ważne pliki i katalogi

• Ścieżka instalacji: /root/roundcube
• Plik Compose: /root/roundcube/docker-compose.yml
• Plik środowiskowy: /root/roundcube/.env
• Dodatkowa konfiguracja: /root/roundcube/config/custom.inc.php
• Wolumin bazy danych: /var/lib/docker/volumes/roundcube_db_data
• Konfiguracja Nginx: /etc/nginx/sites-available/roundcube
• Certyfikat TLS: /etc/nginx/ssl/roundcube.crt
• Klucz prywatny TLS: /etc/nginx/ssl/roundcube.key

Domena i HTTPS

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

2. Zainstaluj Certbota:

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. Wystaw certyfikat TLS:

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

5. Edytuj /etc/nginx/sites-available/roundcube i zaktualizuj ssl_certificate oraz ssl_certificate_key dyrektywy, aby używały Twojego certyfikatu 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. Przetestuj konfigurację:

nginx -t

7. Przeładuj NGINX:

systemctl reload nginx

8. Otwórz przeglądarkę i wejdź pod adres: https://yourdomain.com

Uwagi

• Roundcube is publicly accessible through Nginx on ports 80 oraz 443.
• The Roundcube container itself listens only on 127.0.0.1:8000.
• MariaDB to wewnętrzna usługa Dockera i nie jest bezpośrednio wystawiona na hoście.
• Domyślny interfejs webowy używa samopodpisanego certyfikatu TLS.
• The upload limit is set to 25 MB; increase both UPLOAD_MAX_FILESIZE and Nginx's client_max_body_size for larger uploads.
• Dostosuj konfigurację Roundcube do swoich preferencji.