X-Git-Url: https://vcs.fsf.org/?p=squirrelmail.git;a=blobdiff_plain;f=INSTALL;h=a3754fba4ee9b7a023ec82087770d4b5e95e4ac7;hp=f242ce9ce1aabf3f963df9f50fce4fc510b7e5b1;hb=2d4e0c66770ff89e362dcb550ce9b2fc7efeb00d;hpb=3b3d853fc0fe4d408956a7bd9358ca6dde0b1a13 diff --git a/INSTALL b/INSTALL index f242ce9c..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 @@ -84,7 +92,7 @@ d. Running into trouble SquirrelMail is still under development. Therefore you should always get the newest version around. Look at - http://squirrelmail.sourceforge.net/index.php3?page=5 to see what it + http://www.squirrelmail.org/index.php3?page=5 to see what it is. If you want to be bleeding edge you might want to consider using the latest CVS version (with the latest and most fashionable of bugs). @@ -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,34 +128,43 @@ 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 ----------------------- - Point your browser at the URL at which SquirrelMail is installed. It - should be pretty stright forward to use. Some more documentation - might show up onbe day or another. + Point your browser at the URL at which SquirrelMail is installed. A + possible example of this is: + http://www.yourdomain.com/squirrelmail + + It should be pretty stright forward to use. Some more documentation + might show up one day or another. 5. RUSSIAN CHARSETS