X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=INSTALL;h=58582b33108a9d4db7d16e5135c46ef7e0f6a63d;hb=aab2c92c21d1ba8ce8d295aac9d1418269403f38;hp=b15089c02c749469c82368c240ff81a5a08d8024;hpb=d68a3926944cc2ecf743b0e9389fa5f463445910;p=squirrelmail.git diff --git a/INSTALL b/INSTALL index b15089c0..58582b33 100644 --- a/INSTALL +++ b/INSTALL @@ -20,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 @@ -107,12 +112,12 @@ b. Setting up directories The data directory is used for storing user preferences, like signature, name and theme. When unpacking the sources this directory - is created as data/ in you SquirrelMail directory. This directory + is created as data/ in your SquirrelMail directory. This directory must be writable by the webserver. If your webserver is running as - the user nobody you can fix this by running: + 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 @@ -123,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