File roundcubemail-README.SUSE of Package roundcubemail

= How to set up roundcubemail for the first time =

(see further below for hints on how to update an existing installation)

== Step 1. Configure mysql ==

First, start it:

rcmysql start (upon the very first start, it is initialized)

set root passwort:

/usr/bin/mysqladmin -u root password 'secret'

Create database named "roundcubemail" and grant a user authenticating as 
"roundcube" all permissions on it:

<pre>
# mysql -u root -p
mysql> create database roundcubemail DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
Query OK, 1 row affected (0.02 sec)

mysql> GRANT ALL PRIVILEGES ON roundcubemail.* TO roundcube@localhost IDENTIFIED BY 'otherpassword';
Query OK, 0 rows affected (0.02 sec)

mysql> quit
       Bye
</pre>

initialize roundcubemail database:
<pre>
# mysql roundcubemail < /usr/share/doc/packages/roundcubemail/SQL/mysql5.initial.sql
</pre>

== Step 2. Configure roundcubemail ==

Edit __ROUNDCUBEPATH__/config/db.inc.php to contain the right password and username for accessing the 
mysql database. See $rcmail_config['db_dsnw'] line.

Change the fie __ROUNDCUBEPATH__/config/main.inc.php according your to environment and your needs.

== Step 2b. Adapt apache configuration ==

Edit __HTTPCONFDIR__/roundcubemail.conf if needed. The default sould be ok.

== Step 3. Enyoi ==

Start apache2, open the URL:
 http://localhost/roundcube

in a browser and login with a username and password recognised by your imap server.

= Upgrading from previous versions =

If you already have a previous version of RoundCube installed,
please refer to the instructions in UPGRADING guide.