X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=INSTALL;h=a3754fba4ee9b7a023ec82087770d4b5e95e4ac7;hb=ec6762416d9243d08bc94344d506cf4421aed385;hp=77181a7e584b801baa48b59b5bac657f006f3aee;hpb=429f8906ba14dd45dc3dd2c6d15d74bfcebd6703;p=squirrelmail.git diff --git a/INSTALL b/INSTALL index 77181a7e..a3754fba 100644 --- a/INSTALL +++ b/INSTALL @@ -1,3 +1,6 @@ +Installing SquirrelMail +======================= + Table of Contents: 1. (PHP4) Configure your webserver to work with PHP4 2. (IMAP) Setting up IMAP (not covered) @@ -17,6 +20,11 @@ Table of Contents: to run as CGI under Apache. How you end up doing this is up to you (your mileage may vary). + NOTE: The new plugin architecture required the use of some functions + which are not in all versions of PHP4. You will need at least + PHP4 beta2. If you need to upgrade please go ahead and install the + latest release version of PHP4. + a. Obtaining and compiling PHP4 Point your favorite webserver at http://www.php.net/version4/ and @@ -108,8 +116,8 @@ b. Setting up directories must be writable by the webserver. If your webserver is running as the user nobody you can fix this by running: - chown -R nobody data - chgrp -R nobody data + $ chown -R nobody data + $ chgrp -R nobody data There also needs to be a directory where attachments are stored before they are sent. Since personal mail is stored in this @@ -120,26 +128,32 @@ b. Setting up directories permissions. You could do this by running these commands (still granted that the webserver is running as nobody/nobody) - cd /var/some/place - mkdir SomeDirectory - chgrp -R nobody SomeDirectory - chmod 730 SomeDirectory + $ cd /var/some/place + $ mkdir SomeDirectory + $ chgrp -R nobody SomeDirectory + $ chmod 730 SomeDirectory If you trust all the users on you system not to read mail they are not supposed to read change the last line to chmod 777 SomeDirectory - or simply use /tmp as you attachments directory. If a user is - aborting a mail but has uploaded som attachments to it the files - will be lying around in this directory forever if you do not remove - them. + or simply use /tmp as you attachments directory. + + If a user is aborting a mail but has uploaded som attachments to it + the files will be lying around in this directory forever if you do not + remove them. To fix this, it is recommended to create a cron job that + deletes everything in the attachment directory. Something similar + to the folling will be good enough: + + $ cd /var/attach/directory + $ rm -f * c. Setting up SquirrelMail There are two ways to configure Squirrelmail. In the config/ directory, there is a perl script called conf.pl that will aid you in the - configuration process. This is the most recommended way of handling + configuration process. This is the recommended way of handling the config. - You can also copy the config/config_default.php file to config.php + You can also copy the config/config_default.php file to config/config.php and edit that manually. 4. RUNNING SQUIRRELMAIL