Roundcube, PHP ile yazılmış ve IMAP protokolünü kullanan açık kaynaklı bir web tabanlı e-posta istemcisidir. E-posta gönderme, alma, yanıtlama ve iletme gibi işlemleri basit bir arayüzle gerçekleştirmenizi sağlar. Ayrıca kullanıcılar, kendi adres defterlerini oluşturabilir ve gruplar tanımlayarak iletişimlerini daha düzenli bir şekilde yönetebilir.

Table of Contents

Kurulum Öncesi Sistem Gereksinimlerini

Roundcube Webmail’in stabil çalışabilmesi için bazı temel sistem gereksinimlerinin karşılanması gerekir. Bu gereksinimler, hem yazılım uyumluluğu hem de güvenli ve yüksek performanslı bir kurulum açısından oldukça önemlidir.

İlk olarak, Ubuntu 20.04 veya üzeri bir sürüm önerilir. Bu dağıtım, Roundcube’un ihtiyaç duyduğu güncel paketleri içerir. Web sunucusu olarak Apache ya da Nginx kullanılabilir; her ikisi de uyumludur ancak kurulum adımları farklılık gösterebilir. Özellikle Plesk Apache altyapısını kullanan sistemlerde, modül yapılandırmalarına dikkat edilerek sorunsuz entegrasyon sağlanabilir.

PHP tarafında, minimum 7.4 sürümü kullanılmalı ve php-imap, php-mbstring, php-intl, php-curl, php-mysql gibi gerekli eklentiler mutlaka kurulmalıdır. Eksik eklentiler, Roundcube arayüzünde işlevsel sorunlara yol açabilir. Ayrıca Roundcube İmza özelliğinin düzgün çalışabilmesi için imza düzenleme izinlerinin ve HTML desteğinin aktif olması gerekir.

Veritabanı olarak ise MariaDB veya MySQL tercih edilmelidir. Bu sistemlerden biri hazır ve yapılandırılmış olmalıdır.

Son olarak, webmail.domain.com gibi bir DNS A kaydı oluşturulmalı ve bu kayıt sunucunun IP adresine yönlendirilmelidir. Bu, arayüze erişimi kolaylaştırır ve kurumsal bir görünüm sağlar.

ChatGPT’ye sor

Roundcube Kurulumu

Sistem Güncellemeleri Yapılması

Öncelikle sistemdeki mevcut yazılım paketlerini en güncel hale getirelim.

sudo apt update && sudo apt upgrade -y

PHP ve Bağımlılıkları Kurulumu

Apache ya da Nginx ile uyumlu çalışacak PHP ve gerekli modülleri kuralım.

sudo apt install php php-mbstring php-intl php-curl php-xml php-zip php-mysql unzip -y

Composer (bağımlılık yöneticisi) kurulumu:

sudo apt install composer -y

Apache veya Nginx Kurulumu

Apache Kurulumu;

sudo apt install apache2 -y
sudo systemctl enable --now apache2

Nginx Kurulumu;

sudo apt install nginx -y
sudo systemctl enable --now nginx

Roundcube için bir Veritabanı Kurulumu

Roundcube’un çalışabilmesi için kullanıcı bilgilerini ve yapılandırma verilerini saklayabileceği bir veritabanı gereklidir. Bu veritabanı olarak MariaDB ya da MySQL sistemlerinden biri rahatlıkla kullanılabilir.

MariaDB’yi Kuralım

$ sudo apt install mariadb-server -y

Veritabanı ve kullanıcı tanımlama işlemi için aşağıdaki kod dizilimini uygulayalım.

CREATE DATABASE roundcubedb CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'roundcubeuser'@'localhost' IDENTIFIED BY 'GucluParola123!';
GRANT ALL PRIVILEGES ON roundcubedb.* TO 'roundcubeuser'@'localhost';
FLUSH PRIVILEGES;

Roundcube’un En Güncel Sürümünü İndirelim

wget https://github.com/roundcube/roundcubemail/releases/download/1.6.9/roundcubemail-1.6.9-complete.tar.gz
tar -xzf roundcubemail-1.6.9-complete.tar.gz
mv roundcubemail-1.6.9 /var/www/roundcube
sudo chown -R www-data:www-data /var/www/roundcube
sudo chmod -R 755 /var/www/roundcube

Apache’yi Roundcube İçin Yapılandıralım

Yeni bir yapılandırma dosyası oluşturup, terminal kodlarını ekleyelim.

ServerName webmail.domain.com DocumentRoot /var/www/roundcube Options FollowSymLinks AllowOverride All Require all granted

Siteyi aktif hale getirelim ve Apache hizmetini yeniden başlatarak değişikliklerin uygulanmasını sağlayalım.

Nginx’i Roundcube İçin Yapılandıralım

Yeni bir yapılandırma doyası oluşturduktan sonra kodları ekleyelim.

server {
listen 80;
server_name webmail.domain.com;
root /var/www/roundcube;
index index.php;

location / {
    try_files $uri $uri/ /index.php;
}

location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php7.4-fpm.sock;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

location ~ /\.ht {
    deny all;
}

Web Arayüzü Üzerinden Roundcube Kurulumunu Tamamlayalım

Kurulumu tamamlamak için tarayıcınızda http://yourdomain.com/installer adresine gidin. Açılan sayfada sistem gereksinimlerini kontrol edin ve veritabanı yapılandırma ekranına geçin. Daha önce oluşturduğunuz veritabanı adı, kullanıcı adı ve şifresini girerek kurulumu tamamlayabilirsiniz. Kurulum bittikten sonra, güvenlik açısından installer klasörünü silmeniz gerekir.

Roundcube arayüzüne erişmek için webmail.yourdomain.com adresinin sunucu IP’sine yönlendirilmiş bir DNS A kaydı tanımlanmalıdır. Bu kayıt, kullanıcıların tarayıcı üzerinden webmail arayüzüne doğrudan erişmesini sağlar.

HTTPS Güvenliği Ekleyelim

Roundcube erişimini şifreleyerek daha güvenli hale getirmek için Let’s Encrypt üzerinden ücretsiz SSL sertifikası kullanabilirsiniz.

Certbot’u yükleyin:

sudo apt install certbot python3-certbot-apache -y

Apache kullanıyorsanız:

sudo certbot --apache -d yourdomain.com -d webmail.yourdomain.com

Nginx kullanıyorsanız:

sudo apt install python3-certbot-nginx -y
sudo certbot --nginx -d yourdomain.com -d webmail.yourdomain.com

Test ve Doğrulama Araçları

Roundcube yapılandırmanızın sağlıklı çalıştığından emin olmak için aşağıdaki test araçlarını kullanabilirsiniz:

mail-tester.com: Gönderdiğiniz e-postaların spam puanını analiz ederek olası sorunları tespit eder.
mxtoolbox.com: DNS, MX, SPF ve DKIM gibi e-posta yapılandırma kayıtlarınızı kontrol etmenizi sağlar ve olası hataları bildirir.

Sık Sorulan Sorular (SSS)

Roundcube kurulu ama gelen e-postalar gözükmüyor, ne yapmalıyım?

Bu genellikle IMAP bağlantısının başarısız olması veya mail dizininin yanlış tanımlanmasıyla ilgilidir. systemctl status dovecot komutuyla Dovecot servisinin çalıştığını kontrol edin ve mail_location ayarının doğru yapılandırıldığından emin olun. Ayrıca INBOX klasörünün otomatik oluşturulup oluşturulmadığını kontrol edin.

Roundcube çok yavaş çalışıyor, özellikle büyük posta kutularında neden?

10.000’den fazla e-postaya sahip posta kutularında IMAP işlemleri yoğun kaynak kullanabilir. PHP-FPM ayarlarında pm.max_children ve max_execution_time gibi parametreleri yükseltmeniz gerekir. Ek olarak OPcache’i etkinleştirin ve Redis ya da Memcached gibi önbellekleme sistemleri kurarak performansı artırın. Gelen kutusunu alt klasörlere bölmek de faydalı olur.

SMTP error (454): Authentication failed hatası alıyorum, neden?

Bu hata, SMTP yapılandırmasında kimlik doğrulama bilgilerinin doğru olmamasıyla ilgilidir. Roundcube’un config.inc.php dosyasında SMTP sunucu adresi, bağlantı portu, güvenlik protokolü ve giriş bilgileri dikkatle kontrol edilmelidir. Ayrıca, Postfix ayarlarında SASL desteği etkin değilse oturum açma işlemi başarısız olur.

Güncellemeden sonra Roundcube 500 hatası veriyor, nasıl çözülür?

Yükseltme sonrası sık karşılaşılan bu hata genellikle config uyumsuzlukları veya dosya/dizin izinlerinden kaynaklanır. Apache ya da Nginx loglarına göz atın (/var/log/apache2/error.log veya /var/log/nginx/error.log). chown -R www-data:www-data /var/www/roundcube komutunu çalıştırarak kullanıcı izinlerini düzeltelim. Ayrıca veritabanı bağlantı bilgilerini config.inc.php üzerinden doğrulamamız gerekmektedir.

Roundcube kurulu, ama ek dosya gönderemiyorum. upload_max_filesize hatası olabilir mi?

Evet. Bu genellikle PHP yapılandırma sınırlarından kaynaklanır. /etc/php/7.4/apache2/php.ini ya da php-fpm.ini içinde şu değerleri artırıralım;

upload_max_filesize = 25M
post_max_size = 30M
memory_limit = 128M

Apache ve Nginx ile Roundcube Webmail Nasıl Kurulur?