27 May 2019: Changed to use extracting directly to web directory. Protection measures added.
8 May 2019: All "/var/www/web" changed to "/var/www/html/web". "<version number>" used instead of a specific number. More descriptions on settings added.
25 Dec 2014: First created.
Install new by downloading
The usual software installation command "$ sudo apt install roundcube" does not appear to work.
Download roundcubemail-<version number>-complete.tar.gz by selecting "Complete: <version number>" at http://roundcube.net/download/, usually to own "Downloads" directory.
Extract the compressed file, move the extracted directory and files to underneath "/var/www/html", and rename the directory as "roundcube".
Ensure that the hidden ".htaccess" file is also moved.
A quicker way is to extract directly to "/var/www/html" and rename the directory there.
Install Roundcube under "/var/www/html":
$ cd /var/www/html $ sudo tar -xzfv /home/<own account name>/Downloads/roundcubemail-<version number>-complete.tar.gz (extract to current directory) $ ls (see the existence of the extracted directory) $ sudo mv roundcubemail-<version number> roundcube (change direcotry name) $ sudo chown www-data:www-data logs $ sudo chown www-data:www-data temp
"-xzfv" can be remembered as extract zipped file verbose.
(changed to use "tar" directly to web directory, 27 May 2019)
Install MySQL database + PHP + phpMyAdmin, if not already installed.
Login phpmyadmin at web browser:
Create a database user "roundcube" with database "roundcube":
- click "Users" at the top menu bar
- click "Add user" at the page middle
- enter "roundcube" at the User name entry
- select "Local" at the Host entry
- enter and re-type the password
- click "Create database with same name and grant all privileges"
- click "Go" at the bottom
Enter at web browser:
- accept all of the defaults
- enter database user "roundcube", database "roundcube" and password under Database setup
- click: "CREATE CONFIG"
- download the configuration file generated and save it as config.inc.php
- move the downloaded file:
$ mv /home/<own account name>/Downloads/config.inc.php /var/www/html/roundcube/config
- click: "CONTINUE" on the webpage
- click: "Initialize database"
- set to use secure SMTP port 465
- enter sender and recipient email addresses to test SMTP config
- enter username and password to test IMAP config
Remove or rename installer directory, and protect logs and temp directories:
$ sudo cd /var/www/html/roundcube $ sudo rm -R installer $ sudo mv installer installer.original $ sudo chown -R $USER:$USER logs $ sudo chown -R $USER:$USER temp
(revised to add protection, 27 May 2019)
Configure PHP5 only (not necessary for PHP7):
$ sudo gedit /etc/php5/apache2/php.ini
date.timezone = Asia/Hong_Kong
otherwise the date column of the web mail would be blank.
Restart Apache2 service:
$ sudo systemctl reload apache2 or $ sudo service apache2 reload
Log in at web browser:
Click Settings > Identity to define some settings:
Click Settings > Preferences > User Interface > Date format > 24/7/2019 > Save.
Click Settings > Preferences > Composing Messages
> Compose HTML messages > always.
> when replying > start new message above the quote.
> deselect Force standard separator in signatures.
Click Settings > Contacts > Import to import contacts files, e.g. previously exported from Google.
(more descriptions on settings added, 8 May 2019)
Download and extract the subdirectory of the new version to "Downloads" directory as "roundcubemail-<new version number>".
Upgrade existing directory using the installto.sh script:
$ cd /home/<own account name>/Downloads/roundcubemail-<new version number>/bin $ ./installto.sh /var/www/html/roundcube
In case of big trouble
$ sudo apt-get remove roundcube
$ cd /var/www/html $ sudo rm -r roundcube
Delete mySQL user "roundcube" and database "roundcube" using phpMyAdmin.
Intall Roundcube as new.