aboutsummaryrefslogtreecommitdiffstats
path: root/mail-client/roundcube/files/postinstall-en.txt
diff options
context:
space:
mode:
authorAlexander Sulfrian <alexander@sulfrian.net>2010-09-25 11:35:20 +0200
committerAlexander Sulfrian <alexander@sulfrian.net>2010-09-25 11:40:36 +0200
commitc8d130044762aeb126ec64f188fc2950dd43f5df (patch)
tree54423f29d2233b322f37fe99f6e2a537b7c5f92a /mail-client/roundcube/files/postinstall-en.txt
parent116b84783fd6e13dbd9414ae982e48982a4a0f59 (diff)
downloadoverlay-c8d130044762aeb126ec64f188fc2950dd43f5df.tar.gz
overlay-c8d130044762aeb126ec64f188fc2950dd43f5df.tar.xz
overlay-c8d130044762aeb126ec64f188fc2950dd43f5df.zip
added roundcube fix for >dev-lang/php-5.3
Diffstat (limited to '')
-rw-r--r--mail-client/roundcube/files/postinstall-en.txt77
1 files changed, 77 insertions, 0 deletions
diff --git a/mail-client/roundcube/files/postinstall-en.txt b/mail-client/roundcube/files/postinstall-en.txt
new file mode 100644
index 0000000..9b82afd
--- /dev/null
+++ b/mail-client/roundcube/files/postinstall-en.txt
@@ -0,0 +1,77 @@
+0. DATABASE SETUP
+
+
+* MySQL 4.1.x/5.x
+-----------------
+For MySQL version 4.1 and up, it's recommended to create the database for
+RoundCube with utf-8 charset. Here's an example of the init procedure:
+
+# mysql
+> CREATE DATABASE roundcubemail DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
+> GRANT ALL PRIVILEGES ON roundcubemail.* TO roundcube@localhost
+ IDENTIFIED BY 'password';
+> quit
+
+# mysql roundcubemail < ${MY_INSTALLDIR}/SQL/mysql5.initial.sql
+
+* SQLite
+--------
+Sqlite requires specifically php5 (sqlite in php4 currently doesn't
+work with roundcube), and you need sqlite 2 (preferably 2.8) to setup
+the sqlite db (sqlite 3.x also doesn't work at the moment). Here is
+an example how you can setup the sqlite.db for roundcube:
+
+# sqlite -init SQL/sqlite.initial.sql sqlite.db
+
+Make sure your configuration points to the sqlite.db file and that the
+webserver can write to the file and the directory containing the file.
+
+* PostgreSQL
+------------
+To use RoundCube with PostgreSQL support you have to follow these
+simple steps, which have to be done as the postgres system user (or
+which ever is the database superuser):
+
+$ createuser roundcube
+$ createdb -O roundcube roundcubemail
+$ psql roundcubemail
+
+roundcubemail =# ALTER USER roundcube WITH PASSWORD 'the_new_password';
+roundcubemail =# \c - roundcube
+roundcubemail => \i ${MY_INSTALLDIR}/SQL/postgres.initial.sql
+
+All this has been tested with PostgreSQL 8.x and 7.4.x. Older
+versions don't have a -O option for the createdb, so if you are
+using that version you'll have to change ownership of the DB later.
+
+
+1. ROUNDCUBE CONFIGURATION
+
+Modify the files in ${MY_INSTALLDIR}/config/* to suit your local environment
+
+Details about the config parameters can be found in the config files.
+See http://trac.roundcube.net/wiki/Howto_Install for even more guidance.
+
+
+2. PHP CONFIGURATION
+
+ - error_reporting E_ALL & ~E_NOTICE (or lower)
+ - file_uploads On (for attachment upload features)
+ - session.auto_start Off
+ - magic_quotes_gpc Off
+ - memory_limit (increase as suitable to support large attachments)
+
+
+3. WEBSERVER CONFIGURATION
+
+Access through your webserver to at least the following directories should be denied:
+
+ * /conf
+ * /temp
+ * /logs
+
+Roundcube uses .htaccess files to protect these directories if you are using Apache;
+be sure to allow override of the Limit directives to get them taken into account.
+
+If you are NOT using Apache, it is your responsibility to take care of the above as
+needed by your webserver.