INSTALL INSTRUCTIONS

This is my HOW-TO install SquirrelMail on a RedHat system from the instructions available at 
http://www.pccc.com/downloads/.

Because they are a frame work for using the original source code, you should have fairly
good luck in following these how-to's on a variety of Linux distributions.

AUTHOR: Kevin A. McGrail / kmcgrail@pccc.com


#WGET, UNTAR & INSTALL THE VARIOUS SUPPORT DISTRIBUTIONS

#CREATE A TEMP DIR FOR THE TAR FILES
rm -rf /tmp/20040211SQUIRREL/
mkdir /tmp/20040211SQUIRREL
cd /tmp/20040211SQUIRREL

#GET ALL THE TAR FILES
wget http://www.pccc.com/downloads/squirrelmail/current-1.4.X/squirrelmail-1.4.6.tar.bz2
wget http://www.peregrinehw.com/downloads/squirrelmail/current-1.4.X/compatibility-1.3.tar.gz
wget http://www.peregrinehw.com/downloads/squirrelmail/current-1.4.X/attachment_tnef-0.7-1.4.0.tar.gz
wget http://www.peregrinehw.com/downloads/squirrelmail/current-1.4.X/abook_import_export-0.7-1.4.0.tar.gz
#wget http://www.pccc.com/downloads/squirrelmail/current-1.4.X/sqm-144-xss.patch

# HOMEPAGE: http://www.squirrelmail.org/
#
# Install SquirrelMail v1.4.6
#
# NOTE: Untar in a directory underneath your webserver directories!

        cd /htdocs
        tar jxvf /tmp/20040211SQUIRREL/squirrelmail-1.4.6.tar.bz2
        chown root.root -R squirrelmail-1.4.6
        chmod 755 squirrelmail-1.4.6
        ln -s squirrelmail-1.4.6 webmail
        cd webmail
        #patch -p1 < /tmp/20040211SQUIRREL/sqm-144-xss.patch

        chmod 700 configure config/conf.pl

        mkdir attachments
        chmod 733 attachments
        chown httpd.httpd -R data

        ./configure


#GET RID OF TEMP DIR FOR THE TAR FILES
rm -rf /tmp/20040211SQUIRREL/


NOTES:

  1. Recommended Plugins (In no particular order)
        One of the great things about SquirrelMail is the variety and power of the plugins available.  
        Here are just a few that we believe are an excellent starting point:

        abook_import_export -- Address Book Import / Export via CVS
        abook_take (standard) -- Adds a link to take address from an email to your address book
        attachment_tnef -- Decode those annoying Microsoft Winmail.dat files
        compatibility -- Helps make plugins work better and with more versions
        secure_login -- Force a secure login if you have SSL on your server (REQUIRES compatibility) Requires INSTALL steps.  Read INSTALL file.
        delete_move_next (standard) -- Display "Delete, Move to Folder, Next Email prompts"
        Squirrelspell (standard) -- Check your Splelign
        calendar (standard) -- Provides Calendar Interface
        newmail (standard) -- A method for notifying you of new emails

  2. For RedHat up to 7.3 at least, the IMAP server is UW.  You will want to take note of this when configuring.

  3. You may wish to increase the max_upload_size or upload_max_filesize in php.ini.  
     see http://www.squirrelmail.org/wiki/AttachmentSize



#SQL CONFIGURATION
  One of the nice features of Squirrelmail is that it does NOT require MySQL.  However, 
  you can use it to store user settings and address books.  Assuming you've installed
  the apache w/mysql (how-to's at http://www.peregrinehw.com/downloads), here's a
  quick guide:

  mysqladmin -p<DB ROOT PASSWORD> create squirrelmail
  /usr/local/mysql/bin/mysql -p<DB ROOT PASSWORD> squirrelmail
  GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,ALTER ON squirrelmail.* to squirrelmail identified by '<db password>';

  CREATE TABLE address (
     owner varchar(128) DEFAULT '' NOT NULL,
     nickname varchar(16) DEFAULT '' NOT NULL,
     firstname varchar(128) DEFAULT '' NOT NULL,
     lastname varchar(128) DEFAULT '' NOT NULL,
     email varchar(128) DEFAULT '' NOT NULL,
     label varchar(255),
     PRIMARY KEY (owner,nickname), 
     KEY firstname (firstname,lastname)
  );

  CREATE TABLE userprefs (
    user varchar(128) DEFAULT '' NOT NULL,
    prefkey varchar(64) DEFAULT '' NOT NULL,
    prefval BLOB DEFAULT '' NOT NULL,
    PRIMARY KEY (user,prefkey)
  );

  run ./configure and enter mysql://squirrelmail:<db_password>@localhost/squirrelmail for both DSN's