Knowledge Base

Install Squirrelmail with SSH

Connecting to SSH


  1. Open Putty.
  2. In the Hostname field, type in your server's IP address (this should've come in your welcome email, you can also see it from your cPanel home dashboard in the left-hand side toolbar).
  3. Tick the SSH option (make sure the port you see in the text field is 22) 
  4. Click Open.
  5. A black window should appear and it should ask you for your login details.
  6. Introduce the username you use to access cPanel and the password (the same as the info you use for cPanel)

When you complete the above steps you should see something like (with YOUR info):

 login as: solidg
[email protected]'s password: jailshell-2.05b$


Installing SquirrelMail

You'll be directed to your home directory ('/home/username', in my case, '/home/solidg'). Navigate to your public_html folder and type this:


cd public_html


Now you're ready to download SquirrelMail. To download SquirrelMail:


  1. Go here: http://sourceforge.net/projects/squirrelmail/files/stable/1.4.22/squirrelmail-webmail-1.4.22.tar.gz/download.
  2. Type in the following command in Putty:

    wget http://sourceforge.net/projects/squirrelmail/files/stable/1.4.22/squirrelmail-webmail-1.4.22.tar.gz/download

    Once the download is complete, it will say that the file squirrelmail-1.5.0.tar.gz has sucessfully been saved.

  3. To uncompress it type the following into Putty:

    tar -zxf squirrelmail-webmail-1.4.22.tar.gz 

  4. Since we don't need the uncompressed file we're going to delete it by typing in the following into Putty:

    rm squirrelmail-webmail-1.4.22.tar.gz 

  5. Now rename the squirrelmail-1.4.22 directory, which the uncompressed archive created, to anything you want 

    Note: make sure it isn't Webmail, as cPanel uses this directory to redirect you to port 2095. 

  6. Make a directory so that SquirrelMail can save its data, preferably outside the webroot directory so no one has access (name it whatever you want)

    Note: make sure the directory is writeable, so you will have to CHMOD it to 0777. Type in the following in Putty (make sure you replace username by your cPanel username!):

    cd /home/username
    mkdir data
    chmod 0777 data

  7. To set up your data folder, go back to where you replaced SquirrelMail and type (replace mail by the name of the directory you previously renamed):

    cd public_html/mail


That's it, SquirrelMail is installed!


Configuring SquirrelMail

If you're already in the SquirrelMail directory type:
cd config

 There is a file called conf.pl. Type:

Select whatever option suits you from the menu options that appear. Make sure you see and configure every single option. One of the menu options asks you for you data directory. We previously created a directory so make sure you modify the option to include that info! After you finish, press 'S' and then it will ask you to save and write to a file called 'config.php' and press the ENTER key. After you finish just type 'Q' to quit.

To get out of SSH type in the following: