How to Install SquirrelMail on CentOS 7


Squirrelmail is one of the most popular Web-based email clients written in PHP. It has built-in pure PHP support for IMAP and SMTP, and it is designed to render all pages in pure HTML 4.0 with no JavaScript required, for maximum compatibility across browsers. Its installation and configuration is pretty simple. Note that if you have a VPS with WHM/cPanel or DirectAdmin, Squirrelmail comes preinstalled and ready to use with these control panels.

In this tutorial we are going to show you how to install Squirrelmail on a CentOS 7 VPS.

Squirrelmail only has two requirements:

  • A web server with PHP installed. PHP needs to be at least 4.1.0. PHP 4, PHP 5 and PHP 6 are all supported.
  • Access to an IMAP server which supports IMAP 4 rev 1.

To start the Squirrelmail installation, login to your CentOS 7 VPS via SSH as user root

ssh [email protected]_address -p PORT_NUMBER

and make sure that all installed packages on your server are up to date

yum -y update

Squirrelmail package is not available in the official CentOS 7 repositories. hence we will have to enable EPEL repository with the following command

yum -y install epel-release

Now, the Squirrelmail installation is pretty simple and it can be installed through CentOS package manager

yum -y install squirrelmail

Once the webmail client is installed, you can configure it according to your needs by running the configuration script

cd /usr/share/squirrelmail/config/

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 >>

There are different settings in the configuration file, but main things that should be checked and configured are:

  • Set your default domain name (2. Server settings > 1. Domain)
  • Addresses of IMAP and SMTP servers.
  • Type of IMAP server

It is also recommended to modify the organization preferences such as, organization name, logo, title, etc..

Alternatively, Squirrelmail can be installed by downloading its files directly from their official website and place them in the document root directory of your web server.

unzip -d /var/www/html/
mv /var/www/html/squirrelmail-webmail-1.4.22/ /var/www/html/squirrelmail

Once everything is installed and properly configured, you will be able to access Squirrelmail at http://yourIPaddress/squirrelmail . Login with your email account, and start managing your emails through a web browser.