I wanted to set up SquirrelMail on a CentOS Linux system. After verifying that the SquirrelMail package was not already installed with
rpm -qi squirrelmail
,
I installed the SquirrelMail package with yum install squirrelmail
.
The php-mbstring
package is a dependency for the squirrelmail
package, so it was installed as well.
SquirrelMail is installed in /usr/share/squirrelmail
. The
configuration files are installed in /etc/squirrelmail
.
# ls /etc/squirrelmail config_local.php config.php default_pref sqspell_config.php
After the software was installed I ran the configuration script to configure SquirrelMail.
# /usr/share/squirrelmail/config/conf.pl
When I ran the configuration script, I saw the following menu:
SquirrelMail Configuration : Read: config.php (1.4.0) --------------------------------------------------------- Main Menu -- 1. Organization Preferences 2. Server Settings 3. Folder Defaults 4. General Options 5. Themes 6. Address Books 7. Message of the Day (MOTD) 8. Plugins 9. Database 10. Languages D. Set pre-defined settings for specific IMAP servers C Turn color off S Save data Q Quit Command >>
I typed D and hit Enter to configure SquirrelMail for a specific IMAP server. In this case, I'm running dovecot on the server, which is one of the IMAP servers for which the configuration script can optimize SquirrelMail's settings.
SquirrelMail Configuration : Read: config.php --------------------------------------------------------- While we have been building SquirrelMail, we have discovered some preferences that work better with some servers that don't work so well with others. If you select your IMAP server, this option will set some pre-defined settings for that server. Please note that you will still need to go through and make sure everything is correct. This does not change everything. There are only a few settings that this will change. Please select your IMAP server: bincimap = Binc IMAP server courier = Courier IMAP server cyrus = Cyrus IMAP server dovecot = Dovecot Secure IMAP server exchange = Microsoft Exchange IMAP server hmailserver = hMailServer macosx = Mac OS X Mailserver mercury32 = Mercury/32 uw = University of Washington's IMAP server quit = Do not change anything Command >>
I typed dovecot
and hit Enter to configure SquirrelMail
for the dovecot IMAP server. I was then shown the configuration options set
for dovecot.
imap_server_type = dovecot default_folder_prefix =trash_folder = Trash sent_folder = Sent draft_folder = Drafts show_prefix_option = false default_sub_of_inbox = false show_contain_subfolders_option = false optional_delimiter = detect delete_folder = false Press any key to continue...
When I hit a key, I was returned to the main menu. I typed S and hit Enter to save the settings. I was informed "Data saved in config.php". I then typed Q and hit Enter to exit from the configuration script.
The system runs the Apache webserver,
so I then restarted the Apache server with apachectl restart
.
During the installation, the file
/etc/httpd/conf.d/squirrelmail.conf
is created. The file
contains the following lines:
# # SquirrelMail is a webmail package written in PHP. # Alias /webmail /usr/share/squirrelmail
The web interface for SquirrelMail can be accessed at
http://a.example.com/webmail
[substitute the actual name for
your server for a.example.com
]. You should see a login page
where you can login to check email.
You can also test the SquirrelMail configuration using
http://a.example.com/webmail/src/configtest.php
[again,
substitute your actual domain name for a.example.com
].
When that page is displayed, you will see configuration information.
The script will try to check some aspects of your SquirrelMail configuration
and point you to errors whereever it can find them. You need to have run
conf.pl in the config/ directory first, as I mentioned above, before you run
this script. At the bottom of the webpage that is displayed, you should see
"Congratulations, your SquirrelMail setup looks fine to me!"