There is a new version of this tutorial available for Ubuntu 20.04 (Focal Fossa).

The Perfect Server - Ubuntu 9.10 [ISPConfig 3] - Page 5

20 Install SquirrelMail

To install the SquirrelMail webmail client, run

aptitude install squirrelmail

Then create the following symlink...

ln -s /usr/share/squirrelmail/ /var/www/webmail

... and configure SquirrelMail:

squirrelmail-configure

We must tell SquirrelMail that we are using Courier-IMAP/-POP3:

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 on
S   Save data
Q   Quit

Command >>
 <-- D


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


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

              imap_server_type = courier
         default_folder_prefix = INBOX.
                  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 = .
                 delete_folder = true

Press any key to continue...
 <-- ENTER


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 on
S   Save data
Q   Quit

Command >>
 <-- S


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 on
S   Save data
Q   Quit

Command >> S

Data saved in config.php
Press enter to continue...
 <-- ENTER


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 on
S   Save data
Q   Quit

Command >>
 <-- Q

Afterwards you can access SquirrelMail under http://server1.example.com/webmail or http://192.168.0.100/webmail:

 

21 Install ISPConfig 3

To install ISPConfig 3 from the latest released version, do this:

cd /tmp
wget http://downloads.sourceforge.net/ispconfig/ISPConfig-3.0.1.6.tar.gz?use_mirror=
tar xvfz ISPConfig-3.0.1.6.tar.gz
cd ispconfig3_install/install/

(Replace ISPConfig-3.0.1.6.tar.gz with the latest version.)

The next step is to run

php -q install.php

This will start the ISPConfig 3 installer:

[email protected]:/tmp/ispconfig3_install/install# php -q install.php


--------------------------------------------------------------------------------
 _____ ___________   _____              __ _
|_   _/  ___| ___ \ /  __ \            / _(_)
  | | \ `--.| |_/ / | /  \/ ___  _ __ | |_ _  __ _
  | |  `--. \  __/  | |    / _ \| '_ \|  _| |/ _` |
 _| |_/\__/ / |     | \__/\ (_) | | | | | | | (_| |
 \___/\____/\_|      \____/\___/|_| |_|_| |_|\__, |
                                              __/ |
                                             |___/
--------------------------------------------------------------------------------


>> Initial configuration

Operating System: Debian or compatible, unknown version.

    Following will be a few questions for primary configuration so be careful.
    Default values are in [brackets] and can be accepted with <ENTER>.
    Tap in "quit" (without the quotes) to stop the installer.


Select language (en,de) [en]:
 <-- ENTER

Installation mode (standard,expert) [standard]: <-- ENTER

Full qualified hostname (FQDN) of the server, eg server1.domain.tld  [server1.example.com]: <-- ENTER

MySQL server hostname [localhost]: <-- ENTER

MySQL root username [root]: <-- ENTER

MySQL root password []: <-- yourrootsqlpassword

MySQL database to create [dbispconfig]: <-- ENTER

MySQL charset [utf8]: <-- ENTER

Generating a 2048 bit RSA private key
.......+++
...+++
writing new private key to 'smtpd.key'
-----
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [AU]:
 <-- ENTER
State or Province Name (full name) [Some-State]: <-- ENTER
Locality Name (eg, city) []: <-- ENTER
Organization Name (eg, company) [Internet Widgits Pty Ltd]: <-- ENTER
Organizational Unit Name (eg, section) []: <-- ENTER
Common Name (eg, YOUR name) []: <-- ENTER
Email Address []: <-- ENTER
Configuring Jailkit
Configuring SASL
Configuring PAM
Configuring Courier
Configuring Spamassassin
Configuring Amavisd
Configuring Getmail
Configuring Pureftpd
Configuring MyDNS
Configuring Apache
Configuring vlogger
Configuring Firewall
Installing ISPConfig
ISPConfig Port [8080]:
 <-- ENTER

Configuring DBServer
Installing Crontab
no crontab for root
no crontab for getmail
Restarting services ...
 * Stopping MySQL database server mysqld
   ...done.
 * Starting MySQL database server mysqld
   ...done.
 * Checking for corrupt, not cleanly closed and upgrade needing tables.
 * Stopping Postfix Mail Transport Agent postfix
   ...done.
 * Starting Postfix Mail Transport Agent postfix
   ...done.
 * Stopping SASL Authentication Daemon saslauthd
   ...done.
 * Starting SASL Authentication Daemon saslauthd
   ...done.
Stopping amavisd: amavisd-new.
Starting amavisd: amavisd-new.
 * Stopping ClamAV daemon clamd
   ...done.
 * Starting ClamAV daemon clamd
LibClamAV Warning: ***********************************************************
LibClamAV Warning: ***  This version of the ClamAV engine is outdated.     ***
LibClamAV Warning: *** DON'T PANIC! Read http://www.clamav.net/support/faq ***
LibClamAV Warning: ***********************************************************
   ...done.
 * Stopping Courier authentication services authdaemond
   ...done.
 * Starting Courier authentication services authdaemond
   ...done.
 * Stopping Courier IMAP server...
   ...done.
 * Starting Courier IMAP server...
   ...done.
 * Stopping Courier IMAP-SSL server...
   ...done.
 * Starting Courier IMAP-SSL server...
   ...done.
 * Stopping Courier POP3 server...
   ...done.
 * Starting Courier POP3 server...
   ...done.
 * Stopping Courier POP3-SSL server...
   ...done.
 * Starting Courier POP3-SSL server...
   ...done.
 * Restarting web server apache2
 ... waiting    ...done.
Restarting ftp server: Running: /usr/sbin/pure-ftpd-mysql-virtualchroot -l mysql:/etc/pure-ftpd/db/mysql.conf -l pam -A -b -O clf:/var/log/pure-ftpd/transfer.log -8 UTF-8 -u 1000 -E -B
Installation completed.
[email protected]:/tmp/ispconfig3_install/install#

The installer automatically configures all underlying services, so no manual configuration is needed.

Afterwards you can access ISPConfig 3 under http://server1.example.com:8080/ or http://192.168.0.100:8080/. Log in with the username admin and the password admin (you should change the default password after your first login):

The system is now ready to be used.

 

21.1 ISPConfig 3 Manual

 

Share this page:

Suggested articles

24 Comment(s)

Add comment

Comments

By: cmo

Same error here. Mailclient has "Server needs SMTP Authentification" on.

By:

when adding a site with the ispconfig interface, this value is added

php_admin_value open_basedir /var/www/clients/client1/web1/web:/var/www/clients/client1/web1/tmp:/usr/share/php5

The last section /usr/share/php5, is a directory that in the ubuntu packages, only contains php.ini example files.

Is supposed be the folder that contains the php extra functions and classes, which is in /usr/share/php

To change this, the ispconfig developers told me that editing the conf file: /usr/local/ispconfig/server/conf/vhost.conf.master and modify this sections

<tmpl_if name='security_level' op='==' value='20'>
    php_admin_value open_basedir <tmpl_var name='document_root'>/web:<tmpl_var name='document_root'>/tmp:/usr/share/php5
</tmpl_if>

<tmpl_if name='security_level' op='==' value='20'>
    php_admin_value open_basedir <tmpl_var name='document_root'>/web:<tmpl_var name='document_root'>/tmp:/usr/share/php5:/tmp
</tmpl_if>

 

cheers..

By: Robert

This tutorial is really good and clear. Just like the ones for the other distros.

But what's the point of installing ISPConfig 3 ?

If it was installed after step 6 (Install vim-nox (Optional)) on page 3, or even after step 9 (Change The Default Shell) on page 3, it would have made sense.

But we first install everything by hand, and then install a script to manage it all.

Might as well go the extra mile(s) and do everything from the command line.

Why can't ISPConfig ask for (or read a config/setup file with) what you want to install, and then just do it before installing itself ?

And things like :

That the MySQL root user password has to be entered twice. Once when installing MySQL, and then once again when installing ISPConfig.

or

"We need a DNS, mail, and LAMP server, but nevertheless I don't select any of them now because I like to have full control over what gets installed on my system." (page 2), but you do let this happen : "The installer automatically configures all underlying services, so no manual configuration is needed." (page 5).

Anyway, it's a good starting point to have a nice server setup quickly. With or without ISPConfig.

By:

You know, I was just thinking the same thing.

I've never installed this software but, since it's supposed to manage all this stuff, it seems very strange to have to install it all by hand first. 

Certainly none of the steps are difficult to script, most are just one command and some of them answering a couple of prompts.  

It looks like it has to have mySQL installed to be able to have a place for its configs but that should just be the first step; and it should remember that config information.

For a version 3, this is pretty immature...

S

 

By: tono

Never, ever I read a tutorial so good.

Thank you very much.

 

Tono.

By: joerg

Hello,

how can use squirrelmail from this howto, when i create a domain in ispconfig 3?

The symlink from squirrelmail is set to the standard web location /var/www but the web location for the new domain is /var/www/domain.tld/web.

When i link the squirrelmail directory in the  /var/www/domain.tld/web directory i become a error message from squirrelmail. (No input file specified)

Can anybody help me please??

Joerg

By:

Suggestion and question.

Would it not be better to download and phpmyadmin and squirrelmail manually and place them within a allowed directory according to  /usr/local/ispconfig/server/conf/vhost.conf.master?

After <tmpl_if name='security_level' op='==' value='20'>

By: Patrick Nelson

If I could, I'd rate this 5 stars! It is perfect to a tee! Thanks a lot for a very helpful and informative article! Truely an easy and good alternative setup to having to pay for those other control panels!

By:

looks like hetzner's ubuntu 9.10 image isn't as minimal as it sounds :) it seems to have a crippled postfix package already installed, and the ispconfig install will fail because there is no /etc/postfix/main.cf.

to work around this issue, you can remove the package completely before starting with this guide using:

  • aptitude remove --purge postfix
  • dpkg --purge postfix
(the --purge in the first command should also take care of the config files... but it doesn't. calling dpkg manually cleans all the config files.)

 after that the guide works perfectly if you start from step 4.

By: Anonymous

thank you very much for this, it helped me a lot

By: klapifoch

this is an amazing tuto!!! dude thx!

By: Anonymous

maybe ssl on the 8080 port is to be working

By:

Falko .. aswe said in Bulgaria "you are not sleeping" :)

again good job :) 

By: Gaston Suarez Duek

Thx for all the help, my server is now up and running!!!! And just in a couple of hours (or minutes)!!!

By: Warren Bull

This tutorial is absolutely brilliant!

 Thank you sooo much dude!!!

 just one point. i had trouble testing ftp after it was all setup after 3 hours of messing with pureftpd i found a simple solution to the "ERROR: Sorry incorrect address given"

maybe you want to add it to the steps in the tutorial ?

 

Thanks again!

 

By: Big Trucker

Very clear and simple to follow, made the job for me a breeze, thank you!

By: Jack

Used this manual to install postfix and ipconfig. Everything was so well documented so it works from the first try!!!

Great job!!!

Jack 

By: u4david

How would this work out to have /var nad /tmp on separate partitions?

 

Concerned about Quotas on /var to function properly with Ispconfig3 and have /tmp mounted with noexec.

Do not think that separate /boot would create any complications.

Could someoen propose the partitioning schema for Ispconfig3 with

200 gb harddrive to be used on.

and possible changes how to make it all work together as mentioned? 

 

By: Anonymous

Thanks for this step by step tutorial.  It was very easy and straight forward.

 I just have 2 quick questions that maybe you could answer.

 1.)Why use myDNS vs Bind9?

 2.)I can only access ISPConfig via http over port 8080 and not https over port 8080.  how do i reconfigure or setup my server so that it will allow ISPConfig via https over port 8080.

 Thanks alot.

By: Joel

Thanks alot...

but can't send out mail messages using outlook configuration...

this is my error

The following recipient(s) could not be reached:

'[email protected]' on 3/23/2010 7:36 AM

554 5.7.1 <[email protected]>: Relay access denied

anybody can help me?

By:

I am having exact issue

By: Atran

do i have to install  python-policyd-spf after following this guide?

By: Anonymous

In the SquirrelMail Login page I get the following error: Unknown user or password incorrect.

I'm using the administrator user (the one created in this tutorial in the Ubuntu server installation).

Do i have to activate something?

 Thank you!

By: elricho

Excelent tutorial thank you so so so much !!!