ISP-Server Setup - Ubuntu 5.0.4 "The Hoary Hedgehog" - Page 6

3 Installing ISPConfig

I will install the current ISPConfig version. Download the current ISPConfig version from to your /tmp directory.

Unpack the ISPConfig-archive and change to the directory install_ispconfig:

tar xvfz ISPConfig*.tar.gz
cd install_ispconfig

Start the setup script


The installer will now compile an Apache with PHP5 that will run on port 81 and is needed by the ISPConfig system itself. It will not interfere with your existing Apache installation so you can go on unworried.

When the ISPConfig Apache is built, a custom SSL certificate is built. Therefore you are asked a few questions. You can accept the default values, or you can enter new values there, this does not matter:

In step 7 (Encrypting RSA private key of CA with a pass phrase for security [ca.key]) and step 8 (Encrypting RSA private key of SERVER with a pass phrase for security [server.key]) of the certificate creation process you are asked if you want to encrypt the respective key now. Choose n there because otherwise you will always be asked for a password whenever you want to restart the ISPConfig system which means it cannot be restarted without human interaction!

If the compilation fails, the setup is stopped and all compiled files are removed. From the error message you get you should be able to see the reason for the failure (in most cases a package (like the MySQL header files) is missing). Try to solve the problem and the re-run ./setup.

In case of success the setup goes on:

Please choose your language. This is the language of the ISPConfig interface.

Afterwards you are shown the ISPConfig licence (BSD licence). Please read it carefully! You accept it by typing y. If you do not want to accept the ISPConfig licence, type n, and the installation routine stops.

As installation mode I chose expert because i want to set the website root to /var/www. When you are asked for installation mode, type 2 and hit return.

Now you are ask if the daemons like postfix etc. are recognized correctly and for their file locations, chose yes y.

When you are asked:

Web-Root: /home/www
Is this correct? [y/n]

choose n and enter /var/www as Web-Root.

Now you are asked for some installation settings:

Please enter your MySQL server: localhost
Please enter your MySQL user: root
Please enter your MySQL password: (Enter the password you chose when setting up the MySQL Server)

Please enter a name for the ISPConfig database (e.g. db_ispconfig): db_ispconfig
Please enter the IP address of the ISPConfig web (e.g. (Enter your IP here)

Now you are ask to enter the host and domain of your server. If your server has a host and domainname, enter them now. As this is a test install in my local network, I leave the host empty and enter my IP address instead of the domain.

Please enter the host name (e.g. www):
Please enter the domain (e.g.

Please select the protocol (http or https (SSL encryption)) to use to access the ISPConfig system:
Your Choice:

After you have answered the questions ISPConfig should be duly installed. If you indicated www as host and as the domain during the installation, you will find the ISPConfig interface under or Here you can login first with the user name admin and password admin. It is recommended to change the password immediately! This can be done in the ISPConfig web interface under Tools -> Change password.

Then go to Management -> Server -> Settings in the ISPConfig control panel and tick the Maildir checkbox on the EMail tab.

If your server has more than one IP address, please check if your additional IP addresses have been correctly detected by the installation routine under Management -> Server ->
on the tab Server -> IP List.

You can find the whole ISPConfig installation instructions here:

The ISPConfig manuals can be found here:


Share this page:

17 Comment(s)

Add comment



There is an error (minor) in the following paragraph on the last page. ...

After you have answered the questions ISPConfig should be duly installed. If you indicated www as host and as the domain during the installation, you will find the ISPConfig interface under or

The addresses should have .com instead of .de (or the how should be

thanks for the sweet article!

From: admin

Thanks, I've corrected the error.

From: Anonymous

Why cant a iso of this be available to download all ready to run?

flame away ;-)


Crossposted from OSNews:

This is the worst HOWTO I ever read. There is NO explanation what this setup will create NOR is it secure or suitable other than for kids to play on their homeboxen. Postfix has not disabled plaintext without ssl so every client pointing to server:25 and not issuing STARTTLS will get transmit passwords in cleartext. Did I hear ISP? Where is virtual domain support? Are you supposed to have all your mailaccounts in /etc/passwd. What is that Apache setup meant for? Disabling PHP and running php scripts as CGI with Suexec? Ever heard of suphp?

forget it

From: Anonymous

It seems you have not read the howto at all. The howto prepares a server for the installation of the ispconfig controlpanel. If you do not disable PHP globally you can not manage it on a per vhost basis :-) When you have written your own server howto, you can post it here to show everyone what you think a server setup is. E.g. crossposting is :cool:


Hmm, the other guy needs a slap around the ears, not designed for kids at home, he assumes you have a basic idea if you are going to do it, there's also Articles about Virtual Domains on the site, take a chill pill and relax. Nice Article, you may also want to look into running VHCS as well from it's also a Free Opensource Hosting panel, I think it has more features too, plus it's a heck of a lot sexier.

From: Anonymous

everyones a noob at some point

From: Anonymous

Hello I am newbie. It's my first time to have handson on linux. Anyway i followed everything in this article except that when I installed ISPConfig, I got the following error:

Warning: main( failed to open stream: No such file or directory in /tmp/install_ispconfig/install.php on line 624

Warning: main(): Failed opening '' for inclusion (include_path='.:/root/ispconfig/php/lib/php') in /tmp/install_ispconfig/install.php on line 624

Warning: mysql_connect(): Access denied for user: 'root@localhost' (Using password: NO) in /tmp/install_ispconfig/install.php on line 634

Could not connect to db

Restarting some services...

./setup2: line 883: [:==: unary operator expected

./setup2: line 901: /etc/init.d/ispconfig_server: No such file or directory

If you have anyway of fixing this. I would be very grateful.


From: falko
From: Anonymous

my setup is ok now. can you tell me how to add amasvid-new and clam av to this setup?

From: admin

If you use ISPConfig, mailfiltering with Spamassassin and ClamAV are installed and configured? by the ISPConfig installer.

From: Anonymous

i cannot receive email but i can send using outlook client with smtp authentication. also i cannot login using

From: Anonymous

I tried this but had a dickens of a time testing the email addresses. I put "nameserver" on the top of /etc/resolv.conf and to test the DNS, I'd run "host" to see if the virtual address showed up. It did, so I tried setting up email accounts( 2 ) and created the accounts in Thunderbird to send back and forth. They didn't work until I started sending to "[email protected]". Creating a Co-Domain with the Hostname cleared worked. It also resulted in /etc/prostfix/local-host-names file showing the entry( along with the entry ).

Cool HowTo BTW. Now I have to go in and start learning what all is going on. ;-)

I'm thinking this might be nice for a couple of friends who have small biz and need to create temp accounts for customer comm and filesharing.

From: Anonymous

Rather than creating the symlinks manually as you do for the Apache modules you can use the provided tools:

a2enmod include

a2enmod ssl


From: Anonymous

Is it perfect? Probably not.

Handholding? Some, but you really need to bring your own critical thinking to the table if you're to tackle an unforseen glitch.

Thorough? Absolutely. While I (might) agree there's not a lot of detailed explanations to the tasks, it's all here. You couldn't ask for a better blueprint. You wanna know more about the underpinnings of each step? Start digging. At least you now know what questions to ask!

For all the indignant boo hooing, I would say anyone whining about this article has not had to fend for themselves much and is proably still living with their parents.

Thanks for helping this newbie get a better idea of how work is accomplished in Linux!

From: Anonymous

I created some scripts that are a start to automating this process. You can find them here:

Keep in mind that these scripts are not the cure all it just helps automate a bit. Take a look at each one before you use it. I usually run wget and get them all into the /tmp dir and then call on them as needed.

Hope this helps.