| @@ -0,0 +1,57 @@
+= 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.
+
|
