Installation Instructions for ISPConfig 2
If you are looking for installation instructions for ISPConfig 3, please see here.
Operating System: Linux (Kernel 2.2.x or later with glibc6)
(the following distributions are
supported: Mandrake/Mandriva Linux starting version 8.1 or later, RedHat
Linux version 7.3 or later, Fedora Core 1 – 6, Fedora 7 – 15, SuSE Linux version 7.3 or later, Debian Linux version 3.0
or later, Ubuntu 5.04 or later, CentOS 4.1 – 5.6)
- Apache Webserver version 1.3.12 or later / 2.0.40 or later
- Sendmail or Postfix
- Quota Package
- ProFTP as standalone version or vsftpd as inetd/xinetd/standalone version
- PHP 4.0.5 or newer as Apache module
- MySQL data base
- a POP3/IMAP daemon that supports either the traditional
Unix-Mailbox format (e.g. gnu-pop3d, qpopper, ipop3d, popa3d or vm-pop3d) or the Maildir format (e.g. Courier-Imap, Dovecot)
- OpenSSL and mod_ssl for the creation of SSL virtual hosts
- BIND8 / BIND9
- iptables or ipchains
- gcc and cpp, the c and c++ compilers
System Setup Examples
Examples of system setups that work with ISPConfig perfectly out of the box:
Hint: With the system installation, some system files are replaced where adjustments were made.
This can lead to loss of entries in named.conf as well as in the Sendmail/Postfix configuration.
Important: ISPConfig is meant to be installed on new Linux installations with no web sites, so if you run a server with hundreds of web sites and need a control panel that can take care of those existing web sites, then ISPConfig is not for you!
Make sure you have the c and c++ compilers installed on your server (gcc and cpp).
Log in to your shell as root.
Unpack the ISPConfig-archive
tar xvfz ISPConfig*.tar.gz
and change to the directory install_ispconfig:
In this directory please check the file dist.txt and see if the values given there suit to your
Linux installation (they should be suitable for standard installations).
If you change any values please be sure not to change the format of the file.
Then start the setup-script from there:
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.
Important: Be sure to have installed gcc, flex and all the other tools neded for compiling sources before you
run ./setup! You also need to install the MySQL header files which normally come in a package called mysql-devel, mysql-dev, libmysql-devel or something similar. Otherwise PHP5 will not compile, and the installation of ISPConfig stops!
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.
Installation Mode. Please select the installation mode afterwards. You can choose between the standard and the expert mode.
In standard mode the installation routine takes standard settings for your Linux distribution and writes them to the ISPConfig system.
In expert mode the installation routine proposes standard settings to you (e.g. location of the config
file of your FTP server or log file of your mail server) which you can confirm or edit.
In normal circumstances the standard mode should meet your requirements. Select the expert mode if you are familiar with your system.
The installation sript checks if the following software is
- Apache webserver,
- Mail Transport Agent (MTA): Sendmail or Postfix,
- ProFTP or vsftpd,
- Bind8 / Bind9,
- iptables or ipchains.
If any of the packages is not present, the installation routine stops. Install the missing package, delete the directoy install_ispconfig, unpack ISPConfig again and start from the beginning.
In addition to that the syntax of your existing Apache configuration files is checked. If any error is found the installation routine stops.
If all conditions are fulfilled, you are asked a few questions, whose answers are necessary for the installation of ISPConfig.
In case not all conditions are fulfilled the setup script stops. Install the missing software, delete the directoy install_ispconfig, unpack ISPConfig again and start from the beginning.
Afterwards the following information has to be provided:
Please enter your MySQL server:
Please enter your MySQL user:
Please enter your MySQL password:
Your MySQL password
Please enter a name for the ISPConfig database:
Please enter the IP address of the ISPConfig web:
Please enter the host name: E.g. www
Please enter the domain: E.g. xyz.de
Please select the protocol (http or https (SSL encryption)) to use to access the ISPConfig system:
If you want to use your control panel with SSL, select 1. You can then access it under https://www.xyz.de:81.
If you want to access it under http://www.xyz.de:81,
After you have answered the questions ISPConfig should be duly installed. If you indicated www as host and xyz.com as the domain during the installation, you will find the ISPConfig interface under
https://www.xyz.de:81 or http://www.xyz.de:81.
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 under Tools
-> Change password.
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 – > Properties in the register Server -> IP list.
The ISPConfig comes with SpamAssassin, but without the Perl modules needed by
SpamAssassin. Run the following command after the installation of the ISPConfig:
If errors appear you have to install some Perl modules.
perl -MCPAN -e shell
install Net::DNS (when prompted to enable tests, choose “no”)
To leave the Perl shell type
does not return any error everything is fine. You can then
leave SpamAssassin by typing
” CTRL + c”.
If the package Quota is installed during the setup of the ISPConfig system, the following steps have to be done after the installation (the example assumes that that you would like to apply Quota to the directory /home on the partition /dev/hda6):
Edit the file /etc/fstab and look for the entry, in which the directory /home is mentioned, e.g.
/dev/hda6/home ext2 default 1 2
Add the words usrquota and grpquota as follows:
/dev/hda6 /home ext2 defaults,usrquota,grpquota 1 2
Create the files aquota.user and aquota.group in the directory /home:
Change the properties of the new files:
chmod 600 /home/aquota.*
Reboot the server:
shutdown -r now
After the restart you have to do the following: