RoundCube Webmail is a browser-based multilingual IMAP client with an application-like user interface, providing many features which you can expect from an email client such as Outlook and Thunderbird.
Step 1: Download the latest version of RoundCube Webmail from here. Make sure to download the “complete” version to avoid any future inconvenience.
Step 2: Unzip the file using 7-zip (or other similar software) and extract the unzipped folder into the root folder of your server (default at C:\inetpub\wwwroot).
Step 3: Access the installation by typing the following in your browser URL:
“(WebsitePanel IP)/(name of folder containing unzipped roundcubemail files)/installer/” (without quotation marks) and hit Enter.
(example: 127.0.0.1/roundcubemail-1.1.3/installer )
Step 4: RoundCube will check the environment of your server. If there’s a “NOT AVAILABLE” or “NOT OK” next to one to the criteria, try fixing it by installing the missing plugins or software, unless it is stated that only one of them is required such as the databases. Click “Next” at the bottom of the page when the required fields are installed.
Helpful Note: Try using Microsoft Web Platform Installer link to easily install the missing software/plugins.
Step 5: On the Create config page, fill in any setting that you find necessary and click “Create Config” button at the bottom of the page to create a config file. Download it via the “Download” button that appears on top and move it into roundcubemail’s config folder. Click “3. Test config” to go to the next step.
Step 6: This page will check for any issues within your config file. In case that you encounter “NOT OK” in some of these categories, there will be instructions to fix each of them below.
- Check config file: Make sure you have copied the config file which you have created in the previous step into /config of roundcubemail folder. Also, try installing Visual C++ Redistributable for Visual Studio 2012 Update 4, as it might be a .dll problem.
- Check if directories are writable: Modify the permission for these two folders to “Full control” for user “CREATOR OWNER”.
- Check DB config: Click the button under it which initializes your database.
- Test filetype detection: First, open php.ini, then uncomment and set cgi.force_redirect = 0. Next, using PHP Manager for IIS (Can be installed using MS Platform Installer), enable the functions that are listed in the error message which appears after the “NOT OK” warning.
Also, download mimes.type.txt file from the error message and paste it inside roundcubemail’s config folder. Then, set the pathway $config[‘mime_types’] = (dir of mimes.type.txt) in defaults.inc.php.
- Test SMTP config: Test if RoundCubeMail can send mail by using one of the email accounts you have created using hMailServer Administrator as Sender, and any valid email as Recipient. After filling both emails and click “Send test mail”, then check the recipient email to see if the test mail is successfully received. Also, remember to connect to your hMailServer using hMailServer Administrator to ensure the sending is successful.
- Test IMAP config: Test by logging in using the accounts that you have created for your domains in hMailServer, example: firstname.lastname@example.org as username, and password which you have used to access your WebsitePanel.
Step 7: To access RoundCubeMail, just type “(server ip)/(roundcubefolder)/index.php” (without quote marks) into your browser URL, example: 127.0.0.1/roundcubemail-1.1.3/index.php.
Also, remember to remove the installer folder after finishing installation as it may contain confidential data such as password.