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