Knowledgebase

Problem:

How to install RoundCube Webmail on your website.

Solution:

Steps to auto-install the Roundcube script:

1. Login to cPanel.
2. Find the Software/Services section.
3. Click Simple Scripts icon.
4. Select RoundCube.
5. Follow the steps to install it.

If you prefer to manually install Roundcube, please follow these steps below:

1. Download Roundcube from their website at http://roundcube.net.
2. Extract the downloaded file onto your computer using a .tar.gz extraction program such as WinRar or WinZip
3. Login to your Free1host account and click on 'MySQL Databases', then create a database name of your choice. example: myroundcube Note: it will add your Free1host account username and underscore to the front of the database name you create. So the database name will look like username_myroundcube (write down what it's named as we will need it later).
4. Create a username and password under the Users section of mysql Example: myuser Note: The username will also add your Free1host account username in front o the username you create so it will look like username_myuser but your password will be exactly what you typed. Write down what they are we will need them later.
5. In the mysql section there are two drop down boxes under databases select the database you created (username_myroundcube) and then the username you created (username_myuser) and then click the button under them that says Add User to DB.
6. At the bottom of the mysql section there will be a link to PHPMYADMIN. Click on it.
7. On the left select the database you created (username_myroundcube) in the drop down menu.
8. Click on the IMPORT(SQL) tab in the middle top area of the screen.
9. Click the Browse button and browse to the folder we extracted all the files to and go into the SQL folder and click on the file mysql.initial.sql and click open. Then click the GO Button and this will setup the database for Roundcube. Then close out of the browser.
10. Locate the folder you just extracted and then go into the folder called config.
11. Locate file db.inc.php.dist and rename it to db.inc.php.
12. Locate file main.inc.php.dist and rename it to main.inc.php.
13. Click 'Start' in your computer, then 'run' and type in wordpad.exe. WordPad will open.
14. Click File then open and browse to the db.inc.php file (Note: when you browse to open the file you may need to set Files of type to All Documents):
15. Locate the line:
    

             $rcmail_config['db_dsnw'] = 'mysql://roundcube:pass@localhost/roundcubemail';
           

    We will edit this line to put in our database info.
    Where it says "roundcube:pass", you will put in your database username and password there, but keep the colon

             example:  username_myuser:password
           

    Where it says roundcubemail you will fill in your database name there.

             example: username_myroundcube
           

    So it should end up looking something like this, but with your info:

             $rcmail_config['db_dsnw'] = 'mysql://username_myuser:password@localhost/username_myroundcube';
           

16. Click Save and Close wordpad.
17. Click 'start' then 'run' and type in wordpad.exe. WordPad will open again.
18. Click File then open and browse to the main.inc.php file Click File then open and browse to the main.inc.php file (Note: when you browse to open the file you may need to set Files of type to All Documents):
    Find this line:

             $rcmail_config['enable_caching'] = TRUE;
          

    And change the word TRUE; to FALSE;
    Find this line:

             $rcmail_config['default_host'] = '';
          

    Between the two single quotations type mail.yourdomain.com
19. Click Save and Close wordpad.
20. FTP all of the extracted individual files to the folder on your site where you want to install roundcube. Example (folder named: email).

Visit the newly installed Roundcube script by visiting where it is located (example: http://www.yoursite.com/email) and log in with your full email address and password.