Squirrelmail Notes

Installation Packages

-----------------------------

- php5-imap

- Do not use the Ubuntu squirrel mail package.

 

Commands of Interest

-------------------------------

1- wget           to fetch the source file

2- tar zxf        to extract the source file

3- config/conf.pl to configure squirrel mail



Files and Directories

---------------------

1- /usr/src/sqm             scratch area to store source files

2- /var/local/squirrelmail  non-browsable data for squirrel mail





Specific Configuration Tasks

-----------------------------------------------------------------------



To acquire the latest version of squirrel mail sources

------------------------------------------------------

0- su -

1- mkdir /usr/src/sqm

2- cd /usr/src/sqm

3- wget URL_FOR_LATEST_SQUIRREL_MAIL_SOURCES



   Obtain the url by visiting http://www.squirrelmail.org/download.php,

   follow the download instructions, then copy the actual url after

   going through the sourceforge pages.



   FYI: As of this writing the latest stable version of SM is 1.4.10a.

        The installation site is https://site1.horgoth.com/

    The DocumentRoot is /var/www/secure-site1.horgoth.com/





To unpack squirrel mail for an individual virtual host

------------------------------------------------------

0- su - virtual_host_admin

1- cd /var/www/secure-site1.horgoth.com

2- tar jxf /usr/src/sqm/squirrelmail-1.4.10a.tar.bz2

3- mv squirrelmail-1.4.10a sm



To configure squirrel mail for an individual virtual host

------------------------------------------------------

0- su - webadmin

1- cd /var/www/secure-site1.horgoth.com/sm

2- Read and follow the instructions in the INSTALL file

2a- create the user data and attachment directories (see below)

2b- ./config/conf.pl

    + Set the user data and attachment directories with menu options

      4.1 and 4.2

    + Modify the server settings with main menu option 2.

      * Option 2.1 to set the email domain name.

      * Option 2.A.4 to set the IMAP server

      * Option 2.A.5 to set the IMAP port to 993 (SSL enabled)

      * Option 2.A.7 to set the IMAP secure to true.

      * Option 2.B.4 to set the SMTP server

    + Save the changes with 'S'





To create the user data and attachment directories

--------------------------------------------------

0- su -

1- mkdir -p /var/local/sm/site1.horgoth.com/attachment-dir

2- mkdir -p /var/local/sm/site1.horgoth.com/data-dir

3- chown root:www-data /var/local/sm/site1.horgoth.com/attachment-dir

4- chown www-data:www-data /var/local/sm/site1.horgoth.com/data-dir

5- chmod 0730 /var/local/sm/site1.horgoth.com/attachment-dir

6- chmod 0755 /var/local/sm/site1.horgoth.com/data-dir





To test the configuration

--------------------------------------------------

1- Visit https://site1.horgoth.com/sm/src/configtest.php

   You should find a php configuration that needs to be changed.

2- Visit https://site1.horgoth.com/sm

   Login as one of the users.

   Send and receive email.





****************************************************************

Notes:

****************************************************************

  + During use of configtest.php the TLS error can be ignored.

  + Other menu options may be of interest

  + This configuration assumes that the SMTP server has already

    been configured to receive email for the host name in question

    (site1.horgoth.com).  Also, the DNS configuration must be set

    up correctly.