Roundcube webmail telepítése Debian 9-Apache-MySQL környezetben

Összefoglalás

A leírás Debian 9.11 operációs rendszeren készült.

A példák a szöveges fájlok szerkesztéséhez mcedit szövegszerkesztőt feltéteznek (Telepítés: apt-get install mc)

A parancsok root jogot feltételeznek. (állandó root jog: sudo bash)

A szükséges Apache webszerver, MySQL adatbázis szerver és Php futtatókörnyezet az operációs rendszer tárolójából telepítjük.

A pédában Apache-Debian alapértelmezések lesznek használatban: A /var/www/ könyvtár és a www-data user lesz használva.

A Roundcube webmail 1.4.2 Stable kiadása lesz telepítve.

A példában a webszerver, adatbázis szerver és a levelezési szolgáltatások egy hoston futnak. Ezek igény szerint különválaszthatóak.

Webszerver, adatbáziszerver, PHP futtatókörnyezet és szükséges csomagok telepítése

apt-get install -y apache2 mysql-server php php-mysql php-mbstring php-pear php-gd php-imagick php-intl php-zip curl unzip

Roundcube motor telepítése

wget -qO- https://github.com/roundcube/roundcubemail/releases/download/1.4.2/roundcubemail-1.4.2.tar.gz | tar -xzf - -C /var/www/
chown -R www-data:www-data /var/www/roundcubemail-1.4.2

PHP függőségek telepítése

Composer telepítése

Információ

A Debian tárolójában nem a legfrissebb verzió van, ezért manuálisan javasolt telepíteni.

Installer letöltése:

curl -sS https://getcomposer.org/installer -o /tmp/composer-setup.php

Ha szeretnénk, ellenőrizhetjük a telepítőt. A verziók hash -jei.A példában az 1.9.1 verzió hash-je található.

php -r "if (hash_file('sha384', '/tmp/composer-setup.php') === 'baf1608c33254d00611ac1705c1d9958c817a1a33bce370c0595974b342601bd80b92a3f46067da89e3b06bff421f182') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

Composer telepítése: a példában globálisan elérhető lesz a composer, de telepíthetjük a webhost könyvtárába is igény szerint.

php /tmp/composer-setup.php --install-dir=/usr/local/bin --filename=composer
rm /tmp/composer-setup.php

Sikereres telepítés után, ha a composer parancsot attribútum nélkül kiadva megjeleni annak helpje, sikeres a telepítés.

composer

   ______
  / ____/___  ____ ___  ____  ____  ________  _____
 / /   / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__  )  __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
                    /_/
Composer version 1.9.1 2019-11-01 17:20:17

Usage:
  command [options] [arguments]

Composer futtatása

Konfigurációs file átnevezése és futtatás:

cd /var/www/roundcubemail-1.4.2/
mv composer.json-dist composer.json
composer install --no-dev

Javascript függőségek telepítése

cd /var/www/roundcubemail-1.4.2/
bin/install-jsdeps.sh

Adatbázis létrehozása

Feltételezve, hogy a mysql root felhasználónak konzolból nincs jelszava (telepítés alapértelmezett)

SQL futtatása:

• roundcubemail: adatbázis neve
• roundcube: adatbázis felhasználó neve
• password: adatbázis felhasználó jelszava

mysql -uroot -e "CREATE DATABASE roundcubemail CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'roundcube'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON roundcubemail .* TO 'roundcube'@'%';"
mysql -uroot roundcubemail < /var/www/roundcubemail-1.4.2/SQL/mysql.initial.sql

Webszerver konfigurálása

PHP konfigurálása

mcedit /etc/php/7.0/apache2/php.ini

Az alábbi értéket adjuk meg a konfigurációban: Lehetséges értékek

date.timezone =

Apache konfiguráció létrehozása:

mcedit /etc/apache2/sites-available/roundcube.conf

• ServerName: domain név, ami alatt a wiki elérhető lesz. (A domaint konfigurálni kell a kiszolgáló IP címéhez)
• ServerAlias: további domain nevek.
• ServerAdmin: webmester e-mail címe.
• DocumentRoot: A könyvtár, ahová a Roundcube telepítve van.
• VirtualHost: a *:443 a https, a *:80 a http konfiguráció, ha csak az egyik kell, a másik elhagyható
• https konfiguráció
  • SSLCertificateFile: tanúsítvány fájl
  • SSLCertificateKeyFile: privát kulcs file
  • Include (opcionális): tanúsítvány lánc fájl

<IfModule mod_ssl.c>
    <VirtualHost *:443>
            ServerName mydomain.com
            ServerAlias www.mydomain.com
            ServerAdmin webmaster@onlinesoft.org
            DocumentRoot /var/www/roundcubemail-1.4.2/
    
            ErrorLog ${APACHE_LOG_DIR}/error.log
            CustomLog ${APACHE_LOG_DIR}/access.log combined
    
            SSLEngine on
            SSLCertificateFile  /etc/ssl/certs/ssl-cert-snakeoil.pem
            SSLCertificateKeyFile       /etc/ssl/private/ssl-cert-snakeoil.key
            #Include       /etc/ssl/certs/ssl-chain.conf
    </VirtualHost>
</IfModule>

<VirtualHost *:80>
        ServerName mydomain.com
        ServerAlias www.mydomain.com
        ServerAdmin webmaster@onlinesoft.org
        DocumentRoot /var/www/roundcubemail-1.4.2/

        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Apache konfiguráció

ln -s /etc/apache2/sites-available/roundcube.conf /etc/apache2/sites-enabled/roundcube.conf
service apache2 restart

Roundcube configurálása

A Roundube telepítése böngészőben, a beállított domainon az installer könyvtár használatával folytatható.

http(s)://mydomain.com/installer/

Előfeltételek ellenőrzése:

A Roundcube konfigurálása. Amit feltétlen meg kell adnunk:

• Database setup: Adatbázis adatok megadása
• IMAP settings: IMAP levelező szerver adatai
• SMTP settings: SMTP levélküldő szerver datai
• Display settings & user prefs / language: hu_HU (amennyiben magyar oldalt szeretnénk)

Legalul a 'CREATE CONFIG' gombbal létrehozhatjuk a konfigurációt.

Ha ez sikerült, az oldal tetején megjelenik egy üzenet: "The config file was saved successfully into /var/www/roundcubemail-1.4.2/config directory of your Roundcube installation."

Ha változtatni szeretnénk még valamit, akkor most megtehetjük és ismételten a 'CREATE CONFIG' gombbal érvényesíthetjük azt.

Ha minden rendben a 'CONTINUE' gombbal továbbléphetünk.

A konfiguráció befejeztével lehetőség van az IMAP és SMTP fiókok tesztelésére.

A konfiguráció befejeztével biztonsági okokból töröljük az installer könyvtárat.

rm -r /var/www/roundcubemail-1.4.2/installer

A böngészőben az URL-ből távolítsuk el az installer könyvtár hivatkozást.:

http(s)://mydomain.com/

A Roundcube webmail bejelentkezési képernyőjét kapjuk. Érvényes IMAP fiókkal be lehet jelentkezni. Ezzel az alap telepítés kész.