-1. CONFIGURE YOUR WEBSERVER TO WORK WITH PHP4
----------------------------------------------
-
- If your webserver does not already have PHP4 you must configure it
- to work with PHP4. SquirrelMail uses the standard suffix .php for
- all PHP4 files. This is a quick and dirty guide to installing PHP4
- to run as CGI under Apache. How you end up doing this is up to you
- (your mileage may vary).
-
- You will need at least PHP v4.0.6. If you need to upgrade please go
- ahead and install it now.
-
-a. Obtaining and compiling PHP4
-
- SquirrelMail has not been extensively tested for use with PHP 4.3.x.
- See the ReleaseNotes file.
-
- Point your favorite webserver at http://www.php.net/version4/ and
- download the source. Untar (tar xvfz filename-you-downloaded.tgz)
- the source, cd into the directory and run configure. To make PHP4
- work with SquirrelMail a commandline like this should do:
-
- ./configure --enable-track-vars --enable-force-cgi-redirect --with-gettext
-
- If you have a database like MySQL you might want to add something
- like --with-mysql to get database functionality.
-
- If you're going to use LDAP in the addressbook, you must compile PHP4
- with --with-ldap (see the PHP4 docs for more information).
-
- Run make to build the binary file. This will generate a binary file
- called "php". Move this file into a CGI-directory.
-
- You might also want to read the INSTALL file in the PHP-distribution
- :-)
-
-b. Changing php.ini
-
- PHP defaults to look for php.ini (PHP's configuration file) in
- /usr/local/lib. However, for security reasons, it is suggested
- that the location of this file is changed to someplace else. This
- can be done at configure time with the configuration directive
- --with-config-file-path=PATH.
+- Install webserver and PHP4 (at least 4.1.0).
+- Install IMAP server (see docs of that server).
+- Unpack the SquirrelMail package in a web-accessible location.
+- Select a data-dir and attachment dir, outside the webtree (e.g. in /var).
+ The data-dir (for user prefs) should be owned by the user the webserver
+ runs as (eg www-data). The attachment dir (for uploading files as
+ attachments) should be file mode 0730 and in the same group as the
+ webserver.
+- Run config/conf.pl from the command line. Use the D option to load
+ predefined options for specific IMAP servers, and edit at least the
+ Server Settings and General Options (datadir).
+- Browse to http://www.example.com/yourwebmaillocation/src/configtest.php
+ to test your configuration for common errors.
+- Browse to http://www.example.com/yourwebmaillocation/ to log in.