thomascube
2010-02-18 29640bcfa918e9c63d6b29c25d67dc361d20bcca
INSTALL
@@ -12,20 +12,25 @@
* The Apache or Lighttpd Webserver
* .htaccess support allowing overrides for DirectoryIndex
* PHP Version 5.2 or greater including
   - PCRE (perl compatible regular expression)
   - DOM (xml document object model)
   - PCRE, DOM, JSON, XML, Session, Sockets (required)
   - libiconv (recommended)
   - mbstring (optional)
* php.ini options:
   - mbstring, fileinfo, mcrypt (optional)
* PEAR packages distributed with Roundcube or external:
   - MDB2 2.5.0 or newer
   - Mail_Mime 1.6.0 or newer
   - Net_SMTP 1.4.1 or newer
* php.ini options (see .htaccess file):
   - error_reporting E_ALL & ~E_NOTICE (or lower)
   - memory_limit (increase as suitable to support large attachments)
   - memory_limit > 16MB (increase as suitable to support large attachments)
   - file_uploads enabled (for attachment upload features)
   - session.auto_start disabled
   - zend.ze1_compatibility_mode disabled
   - suhosin.session.encrypt disabled
   - mbstring.func_overload disabled
* PHP compiled with OpenSSL to connect to IMAPS and to use the spell checker
* A MySQL or PostgreSQL database engine or the SQLite extension for PHP
* A MySQL, PostgreSQL or MSSQL database engine or the SQLite extension for PHP
* One of the above databases with permission to create tables
* An SMTP server or PHP configured for mail delivery
* An SMTP server (recommended) or PHP configured for mail delivery
INSTALLATION
@@ -38,13 +43,29 @@
   - /logs
3. Create a new database and a database user for RoundCube (see DATABASE SETUP)
4. Point your browser to http://url-to-roundcube/installer/
5. Follow the instructions of the install script (or see MANUAL CONFINGURATION)
5. Follow the instructions of the install script (or see MANUAL CONFIGURATION)
6. After creating and testing the configuration, remove the installer directory
7. Done!
CONFIGURATION HINTS
===================
RoundCube writes internal errors to the 'errors' log file located in the logs
directory which can be configured in config/main.inc.php. If you want ordinary
PHP errors to be logged there as well, enable the 'php_value error_log' line
in the .htaccess file and set the path to the log file accordingly.
By default the session_path settings of PHP are not modified by Roundcube.
However if you want to limit the session cookies to the directory where
Roundcube resides you can uncomment and configure the according line
in the .htaccess file.
DATABASE SETUP
==============
Note: Database for RoundCube must use UTF-8 character set.
* MySQL
-------
@@ -63,9 +84,6 @@
Note 1: 'password' is the master password for the roundcube user. It is strongly
recommended you replace this with a more secure password. Please keep in
mind: You need to specify this password later in 'config/db.inc.php'.
Note 2: For MySQL version 4.1 and up, it's recommended to create the database for
RoundCube with utf-8 charset.
* SQLite
@@ -158,8 +176,8 @@
Apache:
-------
To enable these features in apache the following modules need to be enabled:
 * mod_compress
 * mod_expire
 * mod_deflate
 * mod_expires
 * mod_headers
The optimisation is already included in the .htaccess file in the top