|
|
Line 1: |
Line 1: |
− | Sumber: https://www.linode.com/docs/email/clients/install-roundcube-on-ubuntu/
| + | sumber: https://www.howtoforge.com/tutorial/ubuntu-roundcube-latest/ |
| | | |
| | | |
| + | Install LAMP Server |
| | | |
− | What is Roundcube?Permalink
| + | Before starting, you will need to install Apache, MariaDB, and PHP to your system. First, install Apache and MariaDB with the following command: |
| | | |
− | Roundcube is a web-based IMAP email client that offers a user interface similar to Google’s Gmail. It is a server-side application written in PHP designed to access an email server or service. Email users interact with Roundcube using a web browser.
| + | sudo apt-get install apache mariadb-server php7.2 php7.2-gd php-mysql php7.2-curl php7.2-zip php7.2-ldap php7.2-mbstring php-imagick php7.2-intl php7.2-xml unzip wget curl -y |
− | Before You BeginPermalink
| |
| | | |
− | Familiarize yourself with our Getting Started guide and complete the steps for setting your Linode’s hostname and timezone.
| + | Once all the packages are installed, you will need to change Timezone setting in php.ini file. You can do this with the following command: |
| | | |
− | Complete the sections of our Securing Your Server to create a standard user account, harden SSH access and remove unnecessary network services.
| + | sudo nano /etc/php/7.2/apache2/php.ini |
| | | |
− | This guide is designed to work with our Installing Postfix, Dovecot, and MySQL tutorial, but you can use a different mail server.
| + | Make the following changes: |
| | | |
− | Configure an A HOST or CNAME DNS record (a subdomain) to point at your Linode. For this guide, the subdomain webmail will be used. Refer to our Introduction to DNS Records guide if you need help creating this record.
| + | date.timezone = Asia/Kolkata |
| | | |
− | Update your server’s software packages:
| + | Save and close the file, then start Apache and MariaDB service and enable them to start on boot time using the following command: |
| | | |
− | sudo apt-get update && sudo apt-get upgrade
| + | sudo systemctl start apache2 |
| + | sudo systemctl enable apache2 |
| + | sudo systemctl start mysql |
| + | sudo systemctl enable mysql |
| | | |
− | Note
| + | Download Roundcube |
− | This guide is written for a non-root user. Commands that require elevated privileges are prefixed with sudo. If you’re not familiar with the sudo command, you can check our Users and Groups guide.
| |
| | | |
− | Linux, Apache, MySQL and PHP (LAMP) StackPermalink
| + | First, you will need to download the latest version of Roundcube to your system. You can download it with the following command: |
| | | |
− | This section will cover installing Apache, MySQL, PHP and SSL on your Linode from scratch. If you already have a functioning LAMP stack, skip ahead to the section for Creating an Apache Virtual Host with SSL.
| + | wget https://github.com/roundcube/roundcubemail/releases/download/1.3.6/roundcubemail-1.3.6-complete.tar.gz |
− | Install LAMP Stack PackagesPermalink
| |
| | | |
− | Install the lamp-server^ metapackage, which installs Apache, MySQL, and PHP as dependencies:
| + | Once the download is completed, extract the downloaded file with the following command: |
| | | |
− | sudo apt-get install lamp-server^
| + | tar -xvzf roundcubemail-1.3.6-complete.tar.gz |
| | | |
− | During the installation process, you will be asked to choose a password for the root MySQL user.
| + | Next, move the extracted directory to the Apache web root directory: |
| | | |
− | Secure your new MySQL installation:
| + | mv roundcubemail-1.3.6 /var/www/html/roundcube |
| | | |
− | sudo mysql_secure_installation
| + | Next, give proper permissions to the roundcube directory: |
| | | |
− | Specify your Linode’s time zone in the /etc/php/7.0/apache2/php.ini PHP configuration file. If your server is not using UTC, replace it with your local timezone listed on PHP.net:
| + | sudo chown -R www-data:www-data /var/www/html/roundcube |
| + | sudo chmod -R 775 /var/www/html/roundcube |
| | | |
− | sudo sed -i -e "s/^;date\.timezone =.*$/date\.timezone = 'UTC'/" /etc/php/7.0/apache2/php.ini
| + | Configure the Database |
| | | |
− | Create an Apache Virtual Host with SSLPermalink
| + | By default, MariaDB installation is not secured. So you will need to secure it first. You can secure it by running the following script: |
| | | |
− | We will create a new virtual host for Roundcube in this section. This makes a new webroot for Roundcube, separating it from any other webroots on your Linode.
| + | mysql_secure_installation |
| | | |
− | Position your Linode’s shell prompt within the /etc/apache2/sites-available directory:
| + | Answer all the questions as shown below: |
| | | |
− | cd /etc/apache2/sites-available
| + | Change the password for root ? N |
| + | Remove anonymous users? Y |
| + | Disallow root login remotely? Y |
| + | Remove test database and access to it? Y |
| + | Reload privilege tables now? Y |
| | | |
− | Download a copy of our apache2-roundcube.sample.conf virtual host configuration file. Replace instances of webmail.example.com with the desired domain or subdomain of your installation.
| + | Once the MariaDB is secured, login to MariaDB shell using the following command: |
| | | |
− | sudo wget https://linode.com/docs/assets/roundcube/apache2-roundcube.sample.conf
| + | mysql -u root -p |
− | | |
− | Transfer the file’s ownership to root:
| |
− | | |
− | sudo chown root:root apache2-roundcube.sample.conf
| |
− | | |
− | Next, change the file’s access permissions:
| |
− | | |
− | sudo chmod 644 apache2-roundcube.sample.conf
| |
− | | |
− | Determine what type of Secure Socket Layer (SSL) encryption certificate is best for your Roundcube deployment. A self-signed SSL certificate is easy and free, but triggers an error in most modern browsers reporting that the connection is not private. Let’s Encrypt offers browser trusted, free SSL certificates, but does not support Extended Validation (EV) or multi-domain (wildcard) certificates. To gain those features, a commercial SSL certificate must be used.
| |
− | | |
− | Once you have your SSL certificate, edit the following options in apache2-roundcube.sample.conf to match your desired configuration:
| |
− | ServerAdmin: administrative email address for your Linode (e.g. admin@example.com or webmaster@example.com)
| |
− | ServerName: full domain name of the virtual host (e.g. webmail.example.com)
| |
− | ErrorLog (optional): path to the custom error log file (e.g. /var/log/apache2/webmail.example.com/error.log; uncomment by removing #)
| |
− | CustomLog (optional): path to the custom access log file (e.g. /var/log/apache2/webmail.example.com/access.log; again, uncomment by removing #)
| |
− | SSLCertificateFile: path to the SSL certificate information (.crt) file
| |
− | SSLCertificateKeyFile: path to the SSL certificate private key (.key) file
| |
− | | |
− | Caution
| |
− | Make sure the custom directory and desired .log files exist before specifying them in your virtual host configuration. Failure to do so will prevent Apache from starting. The files should be owned by the www-data user with 644 permissions.
| |
− | | |
− | Rename your configuration file to match its full domain name:
| |
− | | |
− | sudo mv apache2-roundcube.sample.conf webmail.example.com.conf
| |
− | | |
− | Lastly, disable the default Apache virtual host unless you plan to use it.
| |
− | | |
− | sudo a2dissite 000-default.conf default-ssl.conf
| |
− | | |
− | Create a MySQL Database and UserPermalink
| |
− | | |
− | Log into the MySQL command prompt as the root user:
| |
− | | |
− | mysql -u root -p
| |
− | | |
− | Once logged in and the mysql> prompt is shown, create a new MySQL database called roundcubemail:
| |
− | | |
− | CREATE DATABASE roundcubemail;
| |
− | | |
− | Create a new MySQL user called roundcube and assign it a strong password:
| |
− | | |
− | CREATE USER 'roundcube'@'localhost' IDENTIFIED BY 'example_password';
| |
− | | |
− | Grant the new roundcube user full access to Roundcube’s database roundcubemail:
| |
− | | |
− | GRANT ALL PRIVILEGES ON roundcubemail.* TO 'roundcube'@'localhost';
| |
− | | |
− | Flush the MySQL privilege tables to reload them:
| |
− | | |
− | FLUSH PRIVILEGES;
| |
− | | |
− | Log out of the MySQL command prompt and return to a regular Linux shell prompt:
| |
− | | |
− | exit
| |
− | | |
− | Final Preparations for RoundcubePermalink
| |
− | | |
− | Install and enable required PHP packages:
| |
− | | |
− | sudo apt-get install php-pear php7.0-intl php7.0-mcrypt php7.0-mbstring && sudo phpenmod intl mcrypt mbstring
| |
− | | |
− | Enable the Apache modules deflate, expires, headers, rewrite, and ssl:
| |
− | | |
− | sudo a2enmod deflate expires headers rewrite ssl
| |
− | | |
− | Additionally, install the PHP PEAR packages Auth_SASL, Net_SMTP, Net_IDNA2-0.1.1, Mail_mime, and Mail_mimeDecode:
| |
− | | |
− | sudo pear install Auth_SASL2 Net_SMTP Net_IDNA2-0.1.1 Mail_mime Mail_mimeDecode
| |
− | | |
− | Note
| |
− | PEAR is an acronym for “PHP Extension and Application Repository”. Common PHP code libraries, written officially or by third parties, can be easily installed and referenced using the pear command.
| |
− | | |
− | PEAR will print an install ok confirmation message for each package that it successfully installs. In this case, a complete installation will look similar to this:
| |
− | | |
− |
| |
− | install ok: channel://pear.php.net/Auth_SASL-1.1.0
| |
− | install ok: channel://pear.php.net/Net_IDNA2-0.1.1
| |
− | install ok: channel://pear.php.net/Mail_Mime-1.10.2
| |
− | install ok: channel://pear.php.net/Net_Socket-1.2.2
| |
− | install ok: channel://pear.php.net/Net_SMTP-1.8.0
| |
− | install ok: channel://pear.php.net/Mail_mimeDecode-1.5.6
| |
− | | |
− | Download and Install RoundcubePermalink
| |
− | | |
− | Make sure your Linode’s shell prompt is operating inside your user’s home directory. The ~/Downloads folder is preferable, but ~/ is also acceptable.
| |
− | | |
− | cd ~/Downloads
| |
− | | |
− | Download Roundcube. At the time of this writing, the current stable version is 1.3.3, so it will be used for the rest of this guide.
| |
− | | |
− | wget https://github.com/roundcube/roundcubemail/releases/download/1.3.3/roundcubemail-1.3.3-complete.tar.gz
| |
− | | |
− | Decompress and copy Roundcube to the /var/www directory. Again, replace any occurrences of 1.3.3 in the filename with a newer version number if necessary:
| |
− | | |
− | sudo tar -zxvf roundcubemail-1.3.3-complete.tar.gz -C /var/www
| |
− | | |
− | Eliminate the version number from Roundcube’s directory name. This will make updating easier later:
| |
− | | |
− | sudo mv /var/www/roundcubemail-1.3.3 /var/www/roundcube
| |
− | | |
− | Transfer ownership of the /var/www/roundcube directory to the www-data user. This will allow Roundcube to save its own configuration file, instead of you having to download it and then manually upload it to your Linode:
| |
− | | |
− | sudo chown -R www-data:www-data /var/www/roundcube
| |
− | | |
− | Lastly, you should enable Roundcube’s automatic cache-cleaning shell script:
| |
− | | |
− | echo '0 0 * * * root bash /var/www/roundcube/bin/cleandb.sh >> /dev/null' | sudo tee --append /etc/crontab
| |
− | | |
− | This utilizes a cron job to run the cleandb.sh shell script included with Roundcube once per day at midnight. Read our Scheduling Tasks with Cron guide to learn about Cron.
| |
− | | |
− | Enable Roundcube’s Apache Virtual HostPermalink
| |
− | | |
− | Enable the webmail.example.com virtual host you just wrote in the Creating an Apache Virtual Host with SSL section:
| |
− | | |
− | sudo a2ensite webmail.example.com.conf
| |
− | | |
− | Restart Apache to apply all configuration changes and enable your new virtual host:
| |
− | | |
− | sudo service apache2 restart
| |
− | | |
− | The output should be * Restarting web server apache2 ... [ OK ]. If an error is given, use the error messages to troubleshoot your configuration. Missing files, incorrect permissions and typos are common causes for Apache not properly restarting.
| |
− | | |
− | Configure RoundcubePermalink
| |
− | | |
− | Navigate to https://webmail.example.com/installer in a web browser. Again, make sure to replace webmail.example.com with your chosen domain name.
| |
− | | |
− | Begin configuring Roundcube. The first step of Roundcube’s graphical configuration is an environment check. Click on the NEXT button at the bottom of the page to continue.
| |
− | | |
− | Roundcube Webmail Installer
| |
− | | |
− | Note
| |
− | Since Roundcube supports six different SQL engines, five NOT AVAILABLE warnings will appear under the Checking available databases section. MySQL was installed earlier as part of the LAMP stack, so you can ignore these warnings.
| |
− | | |
− | Specify your Roundcube configuration options. The list of options below will get you a proper, working configuration, but you can adjust any unmentioned options as you see fit.
| |
− | General configuration > product_name: Name of your email service.
| |
− | General configuration > support_url: Where should your users go if they need help? A URL to a web-based contact form or an email address should be used. (e.g. http://example.com/support or mailto:support@example.com)
| |
− | General configuration > skin_logo: Replaces the default Roundcube logo with an image of your choice. The image must be located within the /var/www/roundcube directory and be linked relatively (e.g. skins/larry/logo.png). Recommended image resolution is 177px by 49px.
| |
− | Database setup > db_dsnw > Database password: Password for the roundcube MySQL user you created earlier.
| |
− | IMAP Settings > default_host: Hostname of your IMAP server. Set this to ssl:// plus the domain of your email server (e.g. ssl://webmail.example.com).
| |
− | IMAP Settings > username_domain: What domain name should Roundcube assume all users are part of? This allows users to only have to type in their email username (e.g. somebody) instead of their full email address (e.g. somebody@example.com).
| |
− | SMTP Settings > smtp_server: Hostname of your SMTP server. Set this to your email server domain, prefixed with ssl://.
| |
− | SMTP Settings > smtp_user/smtp_pass: Click and check the Use the current IMAP username and password for SMTP authentication checkbox so that users can send mail without re-typing their user credentials.
| |
− | Display settings & user prefs > language: Allows you to select a default RFC1766-compliant locale for Roundcube. For a full listing of the supported language codes, run cat /usr/share/i18n/SUPPORTED on your Linode.
| |
− | Display settings & user prefs > draft_autosave: Most users will expect their drafts to be saved almost instantaneously while they type them. While Roundcube does not offer instantaneous draft saving as an option, it can save a user’s draft every minute. Select 1 min from the dropdown menu.
| |
− | | |
− | Click on the CREATE CONFIG button toward the bottom of the page to save your new configuration. You should see a confirmation message on the corresponding page saying: The config file was saved successfully into RCMAIL_CONFIG_DIR directory of your Roundcube installation.
| |
− | | |
− | Complete the configuration by clicking CONTINUE.
| |
− | | |
− | Roundcube configuration saved successfully
| |
− | | |
− | Lastly, import Roundcube’s MySQL database structure by clicking on the Initialize database button.
| |
− | | |
− | Roundcube MySQL database initialization
| |
− | | |
− | Remove the Installer DirectoryPermalink
| |
− | | |
− | Delete the /var/www/roundcube/installer directory, which contains the web page files just used to configure Roundcube:
| |
− | | |
− | sudo rm -rf /var/www/roundcube/installer
| |
− | | |
− | While Roundcube automatically disabled the installer functionality within its configuration file, deleting the installer directory adds another layer of protection against intruders.
| |
− | | |
− | Verify your Roundcube InstallationPermalink
| |
− | | |
− | Navigate to https://webmail.example.com and log in using your email account’s username and password. If your configuration is functional, Roundcube will allow you to receive, read and send emails from inside and outside of your domain name.
| |
− | | |
− | Roundcube login
| |
− | | |
− | Keeping Roundcube UpdatedPermalink
| |
− | | |
− | Compare the Stable > Complete package version listed on Roundcube’s download page to the version currently installed on your Linode.
| |
− | | |
− | If a newer version is available, replace any occurrences of 1.3.3 with the newest version in the command below. This will download Roundcube to your ~/Downloads directory:
| |
− | | |
− | cd ~/Downloads && wget https://github.com/roundcube/roundcubemail/releases/download/1.3.3/roundcubemail-1.3.3-complete.tar.gz
| |
− | | |
− | Extract and unzip the tarball (.tar.gz file) to ~/Downloads:
| |
− | | |
− | tar -zxvf roundcubemail-1.3.3.tar.gz
| |
− | | |
− | Begin updating Roundcube by executing the /var/www/roundcube/bin/installto.sh PHP script. If you did not install Roundcube in the /var/www/roundcube directory, replace the trailing directory with that of Roundcube’s on your server:
| |
− | | |
− | cd roundcubemail-1.3.3
| |
− | sudo php bin/installto.sh /var/www/roundcube
| |
− | | |
− | Confirm the update by pressing Y and then ENTER. A successful upgrade will print something similar to this:
| |
− | | |
− |
| |
− | Upgrading from 1.3.3. Do you want to continue? (y/N)
| |
− | y
| |
− | Copying files to target location...sending incremental file list
| |
− | | |
− | ...
| |
− | | |
− | Running update script at target...
| |
− | Executing database schema update.
| |
− | This instance of Roundcube is up-to-date.
| |
− | Have fun!
| |
− | All done.
| |
− | | |
− | All done means the update was successful; if you see this message, proceed to step six.
| |
− | | |
− | Delete the Roundcube directory and gzipped tarball from ~/Downloads:
| |
− | | |
− | cd ~/Downloads && rm -rfd roundcubemail-1.3.3 roundcubemail-1.3.3.tar.gz
| |
− | | |
− | ConclusionPermalink
| |
− | | |
− | Now that you have installed Roundcube, you have a free, web-based email client similar to Google’s Gmail. Users can access their email by navigating to https://webmail.example.com.
| |
− | | |
− | From here, you can install plugins to add additional functionality and customize the theme to match your organization’s color scheme.
| |
− | More Information
| |
− | | |
− | You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.
| |
− | | |
− | Roundcube Homepage
| |
| | | |
| + | Enter your root passw**ord, then create a database and user for Roundcube: |
| | | |
| + | MariaDB [(none)]> CREATE DATABASE roundcubedb; |
| + | MariaDB [(none)]> CREATE USER 'roundcube'@'localhost' IDENTIFIED BY 'password'; |
| + | MariaDB [(none)]> GRANT ALL PRIVILEGES ON roundcubedb.* to 'roundcube'@'localhost'; |
| | | |
| + | Next, flush the privileges and exit from the MariaDB shell using the following command: |
| | | |
| + | MariaDB [(none)]> FLUSH PRIVILEGES; |
| + | MariaDB [(none)]> exit; |
| | | |
| + | Next, you need to import initial tables to roundcubedb database. You can do this using the following command: |
| | | |
| + | cd /var/www/html/roundcube |
| + | mysql -u roundcube -p roundcubedb < SQL/mysql.initial.sql |
| | | |
| + | Configure Apache for Roundcube |
| | | |
| + | Next, you will need to create an Apache virtual host file for Roundcube. You can do this with the following command: |
| | | |
| + | sudo nano /etc/apache2/sites-available/roundcube.conf |
| | | |
| + | Add the following lines: |
| | | |
| + | <VirtualHost *:80> |
| + | ServerName 192.168.0.102 |
| + | ServerAdmin admin@example.com |
| + | DocumentRoot /var/www/html/roundcube |
| + | |
| + | ErrorLog ${APACHE_LOG_DIR}/roundcube_error.log |
| + | CustomLog ${APACHE_LOG_DIR}/roundcube_access.log combined |
| + | |
| + | <Directory /var/www/html/roundcube> |
| + | Options -Indexes |
| + | AllowOverride All |
| + | Order allow,deny |
| + | allow from all |
| + | </Directory> |
| + | </VirtualHost> |
| | | |
| + | Save and close the file, then enable virtual host file using the following command: |
| | | |
| + | sudo a2ensite roundcube |
| | | |
| + | Next, enable Apache rewrite module and restart Apache server with the following command: |
| | | |
| + | sudo a2enmod rewrite |
| + | sudo systemctl restart apache2 |
| | | |
| | | |
Line 293: |
Line 115: |
| ==Referensi== | | ==Referensi== |
| | | |
| + | * https://www.howtoforge.com/tutorial/ubuntu-roundcube-latest/ |
| * https://www.linode.com/docs/email/clients/install-roundcube-on-ubuntu/ | | * https://www.linode.com/docs/email/clients/install-roundcube-on-ubuntu/ |
sumber: https://www.howtoforge.com/tutorial/ubuntu-roundcube-latest/
Install LAMP Server
Before starting, you will need to install Apache, MariaDB, and PHP to your system. First, install Apache and MariaDB with the following command:
sudo apt-get install apache mariadb-server php7.2 php7.2-gd php-mysql php7.2-curl php7.2-zip php7.2-ldap php7.2-mbstring php-imagick php7.2-intl php7.2-xml unzip wget curl -y
Once all the packages are installed, you will need to change Timezone setting in php.ini file. You can do this with the following command:
sudo nano /etc/php/7.2/apache2/php.ini
Make the following changes:
date.timezone = Asia/Kolkata
Save and close the file, then start Apache and MariaDB service and enable them to start on boot time using the following command:
sudo systemctl start apache2
sudo systemctl enable apache2
sudo systemctl start mysql
sudo systemctl enable mysql
Download Roundcube
First, you will need to download the latest version of Roundcube to your system. You can download it with the following command:
wget https://github.com/roundcube/roundcubemail/releases/download/1.3.6/roundcubemail-1.3.6-complete.tar.gz
Once the download is completed, extract the downloaded file with the following command:
tar -xvzf roundcubemail-1.3.6-complete.tar.gz
Next, move the extracted directory to the Apache web root directory:
mv roundcubemail-1.3.6 /var/www/html/roundcube
Next, give proper permissions to the roundcube directory:
sudo chown -R www-data:www-data /var/www/html/roundcube
sudo chmod -R 775 /var/www/html/roundcube
Configure the Database
By default, MariaDB installation is not secured. So you will need to secure it first. You can secure it by running the following script:
mysql_secure_installation
Answer all the questions as shown below:
Change the password for root ? N
Remove anonymous users? Y
Disallow root login remotely? Y
Remove test database and access to it? Y
Reload privilege tables now? Y
Once the MariaDB is secured, login to MariaDB shell using the following command:
mysql -u root -p
Enter your root passw**ord, then create a database and user for Roundcube:
MariaDB [(none)]> CREATE DATABASE roundcubedb;
MariaDB [(none)]> CREATE USER 'roundcube'@'localhost' IDENTIFIED BY 'password';
MariaDB [(none)]> GRANT ALL PRIVILEGES ON roundcubedb.* to 'roundcube'@'localhost';
Next, flush the privileges and exit from the MariaDB shell using the following command:
MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> exit;
Next, you need to import initial tables to roundcubedb database. You can do this using the following command:
cd /var/www/html/roundcube
mysql -u roundcube -p roundcubedb < SQL/mysql.initial.sql
Configure Apache for Roundcube
Next, you will need to create an Apache virtual host file for Roundcube. You can do this with the following command:
sudo nano /etc/apache2/sites-available/roundcube.conf
Add the following lines:
<VirtualHost *:80>
ServerName 192.168.0.102
ServerAdmin admin@example.com
DocumentRoot /var/www/html/roundcube
ErrorLog ${APACHE_LOG_DIR}/roundcube_error.log
CustomLog ${APACHE_LOG_DIR}/roundcube_access.log combined
<Directory /var/www/html/roundcube>
Options -Indexes
AllowOverride All
Order allow,deny
allow from all
</Directory>
</VirtualHost>
Save and close the file, then enable virtual host file using the following command:
sudo a2ensite roundcube
Next, enable Apache rewrite module and restart Apache server with the following command:
sudo a2enmod rewrite
sudo systemctl restart apache2
Referensi