SquirrelMail Webmail Setup Howto for RHEL/CentOS 6

SquirrelMail is an open source standards-based webmail package written in PHP. When installed, SquirrelMail is ready out of the box. All it needs is an installed web server like Apache, SMTP server like Postfix, and IMAP server like Dovecot.

Installing SquirrelMail

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.1. Install the EPEL repository package.

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.2. Install squirrelmail using the command below.

yum install squirrelmail

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.3. Start the httpd service. Learn how to start and stop services here.

Configuring SquirrelMail

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.1. Launch the SquirrelMail Configuration utility using the command below.

/usr/share/squirrelmail/config/conf.pl

Image may be NSFW.
Clik here to view.If your Terminal window has a white background, make sure that the colors are off by looking for the command Turn color on. If the command is Turn color off, type in C and press Enter to turn the colors off. This will ensure that you will be able to read all of the text.

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.2. Type in D and press Enter to select the Set pre-defined settings for specific IMAP servers menu. Type in dovecot and press Enter.

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.3. Type in 2 and press Enter to select the Server Settings menu.

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.4. Type in 1 and press Enter to select the Domain menu. Type in your domain name and press Enter. Save your changes and quit when you are done.

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.5. Type the commands below to enable SquirrelMail to function properly under SELinux.

setsebool httpd_can_network_connect on
setsebool httpd_can_sendmail on

Image may be NSFW.
Clik here to view.I recommend installing the Retrieve User Data plugin so the user’s name will appear whenever he or she sends an email in SquirrelMail.

Testing SquirrelMail

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.1. Click the browser icon at the top near the System menu to launch the Firefox web browser.

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.2. In the address box, type in http://localhost/webmail/src/configtest.php and press Enter. Check for any errors.

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.3. In the address box, type in http://localhost/webmail and press Enter. Type in a valid username and password and click Login.

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.3. That’s it, it’s working.

Image may be NSFW.
Clik here to view.If you encounter any problems, check the log file at /var/log/maillog.

Relocating SquirrelMail into the domain root

By default, SquirrelMail is located in the /webmail of your domain. If you prefer to access SquirrelMail from the root of your domain, follow the steps below.

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.

1. Create the file /etc/httpd/conf.d/sqroot.conf containing the lines below.

<VirtualHost *:80>
DocumentRoot /usr/share/squirrelmail
</VirtualHost>

Image may be NSFW.
Clik here to view.If you are using SSL and you want to force users to use SSL, add the Redirect directive inside the VirtualHost section to redirect browsers to the secured version. See the example below.

redirect permanent / https://mail.acme.local

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.2. Restart the httpd service. Learn how to restart services here.

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.3. Now try browsing http://localhost

Related Pages

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.How to customize the login page.

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.How to secure SquirrelMail using SSL.

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.How to add a password change utility.

Image may be NSFW.
Clik here to view.Image may be NSFW.
Clik here to view.How to add Active Directory/LDAP into the SquirrelMail Addressbook.