The Perfect Server - CentOS 5.6 x86_64 [ISPConfig 3]

Version 1.0
Author: Falko Timme
Follow me on Twitter
Last edited 04/11/2011

This tutorial shows how to prepare a CentOS 5.6 x86_64 server for the installation of ISPConfig 3, and how to install ISPConfig 3. ISPConfig 3 is a webhosting control panel that allows you to configure the following services through a web browser: Apache web server, Postfix mail server, MySQL, BIND nameserver, PureFTPd, SpamAssassin, ClamAV, and many more.

Please note that this setup does not work for ISPConfig 2! It is valid for ISPConfig 3 only!

I do not issue any guarantee that this will work for you!


1 Requirements

To install such a system you will need the following:


2 Preliminary Note

In this tutorial I use the hostname with the IP address and the gateway These settings might differ for you, so you have to replace them where appropriate.


3 Install The Base System

Boot from your first CentOS 5.6 CD (CD 1) or the first CentOS 5.6 DVD. Press <ENTER> at the boot prompt:

It can take a long time to test the installation media so we skip this test here:

The welcome screen of the CentOS installer appears. Click on Next:

Choose your language next:

Select your keyboard layout:

I'm installing CentOS 5.6 on a fresh system, so I answer Yes to the question Would you like to initialize this drive, erasing ALL DATA?

Now we must select a partitioning scheme for our installation. For simplicity's sake I select Remove linux partitions on selected drives and create default layout. This will result in a small /boot and a large / partition as well as a swap partition. Of course, you're free to partition your hard drive however you like it. Then I hit Next:

Answer the following question (Are you sure you want to do this?) with Yes:

On to the network settings. The default setting here is to configure the network interfaces with DHCP, but we are installing a server, so static IP addresses are not a bad idea... Click on the Edit button at the top right.

In the window that pops up uncheck Dynamic IP configuration (DHCP) and Enable IPv6 support and give your network card a static IP address (in this tutorial I'm using the IP address for demonstration purposes) and a suitable netmask (e.g.; if you are not sure about the right values, might help you):

Set the hostname manually, e.g., and enter a gateway (e.g. and up to two DNS servers (e.g. and

Choose your time zone:

Give root a password:

Share this page:

31 Comment(s)

Add comment


From: Anonymous at: 2011-04-24 23:41:47 gives a import read failed

 it now redirects to however the rpm --import doesn't seem to use the re-direct.

From: Anonymous at: 2011-05-04 11:50:42

Step 9 link is now:

rpm --import


From: Anonymous at: 2011-05-30 07:30:17

rpm --import

From: Rony Jusman at: 2011-07-29 01:35:06

rpm --import

From: Anonymous at: 2011-06-09 10:07:29

I've got a problem with:


 I tried the other link, but it seems to be a problem with wget itself. I can ping without any problems, so this won't be a network error?

From: erik at: 2011-08-29 18:03:03


 i got a problem with the code:

yum install ntp httpd mysql-server php php-mysql php-mbstring php-mcrypt phpmyadmin

 i get this message error when i do it:

 Error: php53-common conflicts with php-common

 You could try using --skip-broken to work around the problem

 You could try running: package-cleanup --problems

                        package-cleanup --dupes

                        rpm -Va --nofiles --nodigest

The program package-cleanup is found in the yum-utils package

 how can i solve this trouble?? please its very importa i can't conitnue with the installation.

From: ernie at: 2011-09-01 16:45:23

Used How-to HERE

reason being...

Because the version of php on CentOS 5.6 is 5.1.6, we only can install phpMyAdmin 2.x, I choose
# cd /usr/share
# wget
# tar xvfz phpMyAdmin-
# mv phpMyAdmin- phpmyadmin
# rm phpMyAdmin-

From: at: 2011-12-09 05:02:18

With step 9, it will install the php 5.1.x, which is not for some new CMS like Drupal 7.x. So if you want to install php 5.3.x, use the webtatic repo at

After install the repo, you can complete step 9 with command

yum --enablerepo=webtatic install ntp httpd mysql-server php php-mysql php-mbstring php-mcrypt phpmyadmin



From: Marcelo Santabaia at: 2011-05-23 12:24:24

When I type the command:

vi /usr/share/phpmyadmin/

I receive this ERROR:

"/usr/share/phpmyadmin/" E212: Can't open file for writing



From: Anonymous at: 2012-12-22 03:11:10


  you must use this path



    e.x : nano /etc/httpd/conf.d/


From: Hetz Ben Hamo at: 2011-04-20 19:20:46

Trying to install postfix, even by enabling the centosplus repository will not help, since there is an update which is newer then whats available in centosplus.

 Workaround: go to your local centos mirror, go to the centosplus directory, to and download manually the file:

 Then do: yum localinstall postfix-2.3.3-2.el5.centos.mysql_pgsql.x86_64.rpm (it needs to add .. postgresql.. don't ask me why..) and then things will work.

From: at: 2011-05-23 14:35:10
From: Web Age Support at: 2011-06-07 16:43:59

started with:



Commands I entered (as root) to get dovecot-sieve working:

yum install rpm-build

yum install redhat-rpm-config

mkdir -p ~/rpmbuild/{BUILD,RPMS,SOURCES,SPECS,SRPMS}

echo '%_topdir %(echo $HOME)/rpmbuild' > ~/.rpmmacros

yum install make gcc

cd /root

wget ''


rpm -ivh dovecot-devel-1.2.17-0_115.el5.x86_64.rpm 

rpmbuild --rebuild dovecot-sieve-0.1.18-7.src.rpm 

cd /root/rpmbuild/RPMS/x86_64

rpm -e dovecot-sieve

rpm -ivh dovecot-sieve-0.1.18-7.x86_64.rpm 

service dovecot restart

From: Anonymous at: 2011-05-18 11:47:14

Dovecot Warning ...

At the time i wrote this, the AtRPMS repo updated the dovecot from 1.2.16 to 1.2.17 and the current dovecot-sieve package is not in sync. Either you'll need to wait to update their dovecot-sieve package or you need to recompile from sources with rpmbuild.


From: at: 2011-05-19 11:48:03

Hi, Thank you for this really nice guide! Is it possible to give us more instructions about dovecot and 1.2.16 version,
i have installed 1.2.17 and i am trying for about two days now to figure out what was wrong.

I mean how to install or downgrade the  1.16 or perhaps how to recompile the dovecote package.


From: Luca Tocco at: 2011-05-20 13:33:59

Dovecot 1.2.17 not work on this guide from latest update. I have installed courier instead of dovecot and ispconfig work great!


From: Anonymous at: 2011-04-27 03:05:20

you can install the mod_fcgid from fedora epel repository.

From: Curu at: 2011-05-01 01:01:55

also, you can install suphp from rpmfoge repo using:

yum install mod_suphp 

From: at: 2011-07-26 16:36:15

That's good cuz the howto doesn't work: ...

checking for unistd.h... (cached) yes

checking for APR... configure: error: the --with-apr parameter is incorrect. It must specify an install prefix, a

build directory, or an apr-config file.

From: at: 2011-07-27 05:37:21

[root@ispconfig3 sysconfig]# yum install bind-chroot
Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
 * base:
 * extras:
 * rpmforge:
 * updates:
Excluding Packages from Red Hat Enterprise Linux 5 - x86_64 - ATrpms
Reducing Red Hat Enterprise Linux 5 - x86_64 - ATrpms to included packages only
Excluding Packages from Red Hat Enterprise Linux 5 - x86_64 - ATrpms testing
Reducing Red Hat Enterprise Linux 5 - x86_64 - ATrpms testing to included packages only
Setting up Install Process
Resolving Dependencies
--> Running transaction check
---> Package bind-chroot.x86_64 30:9.3.6-16.P1.el5 set to be updated
--> Finished Dependency Resolution

Dependencies Resolved

 Package                Arch              Version                          Repository       Size
 bind-chroot            x86_64            30:9.3.6-16.P1.el5               base             46 k

Transaction Summary
Install       1 Package(s)
Upgrade       0 Package(s)

Total download size: 46 k
Is this ok [y/N]: y
Downloading Packages:
bind-chroot-9.3.6-16.P1.el5.x86_64.rpm                                    |  46 kB     00:01
Running rpm_check_debug
Running Transaction Test
Finished Transaction Test
Transaction Test Succeeded
Running Transaction
  Installing     : bind-chroot                                                               1/1

  bind-chroot.x86_64 30:9.3.6-16.P1.el5

[root@ispconfig3 sysconfig]# chmod 755 /var/named/
[root@ispconfig3 sysconfig]# chmod 775 /var/named/chroot/
[root@ispconfig3 sysconfig]# chmod 775 /var/named/chroot/var/named/
[root@ispconfig3 sysconfig]# chmod 775 /var/named/chroot/var/run/
[root@ispconfig3 sysconfig]# chmod 777 /var/named/chroot/var/run/named/
[root@ispconfig3 sysconfig]# cd /var/named/chroot/var/named/
[root@ispconfig3 named]# ln -s ../../ chroot
[root@ispconfig3 named]# touch /var/named/chroot/var/named/named.local
[root@ispconfig3 named]# cp /usr/share/doc/bind-9.3.6/sample/var/named/named.root /var/named/chroot/var/named/named.root
[root@ispconfig3 named]# touch /var/named/chroot/etc/named.conf.local
[root@ispconfig3 named]# vi /var/named/chroot/etc/named.conf
 (named.conf edited as per the text)
[root@ispconfig3 named]# chkconfig named on
[root@ispconfig3 named]# service named start
Starting named:
Error in named configuration:
/var/named/chroot/var/named/named.local:1: unknown option '$TTL'
/var/named/chroot/var/named/named.local:3: unknown option 'Serial'
/var/named/chroot/var/named/named.local:4: unknown option 'Refresh'
/var/named/chroot/var/named/named.local:5: unknown option 'Retry'
/var/named/chroot/var/named/named.local:6: unknown option 'Expire'
/var/named/chroot/var/named/named.local:7: unknown option 'Minimum'
/etc/named.conf:30: unexpected token near end of file

From: Rolf Ernst at: 2011-09-05 02:59:01

For all it's worth - I am getting the same error. I am installing under OpenVZ - not sure this is related?

From: Anonymous at: 2012-02-08 12:38:47

I have the same error. Have you solved it?

From: at: 2011-12-09 05:06:30

At step 15, if you already install webtatic repo I suggested on page 3 step 9, you don't need to enable the testing repository, just simply run this command to install

yum --enablerepo=webtatic install php php-devel php-gd php-imap php-ldap php-mysql php-odbc php-pear 
php-xml php-xmlrpc php-eaccelerator php-mbstring php-mcrypt php-mhash 
php-mssql php-snmp php-soap php-tidy curl curl-devel perl-libwww-perl 
ImageMagick libxml2 libxml2-devel mod_fcgid php-cli httpd-devel
Or you can enable the repo webtatic by editing the repo file to enabled=1

From: at: 2011-12-09 05:13:03

With my Drupal 7.x site using SuPHP on ISPConfig3, with step to install suphp, I have to change the umask from

umask=0077  => change to umask=0022
Or folders created by Drupal will have wrong permission.

From: Anonymous at: 2011-05-04 10:27:54

how can you run firefox if u didnt instaled gnome or kde...?

From: Anonymous at: 2011-06-14 23:22:18


From: Anonymous at: 2011-07-07 14:56:36


           I install my firth's the ISPConfig 3 in a CentOS 5.6 server. I follow the steps perfectly.

           And only one thing doesnt work. I cant recivied incomming mail. 

          The error is

Final-Recipient: rfc822;
Original-Recipient: rfc822;
Action: failed
Status: 5.1.1
Diagnostic-Code: X-Postfix; unknown user: "suport"


I Seek a lot of forums buy nobody resolve the problem, well, my kind of problem... 

 Thanks to all


CharlyKai from PARAGUAY

From: Anonymous at: 2011-07-21 09:31:34


This is the problem: Diagnostic-Code: X-Postfix; unknown user: "suport"

 Maybe, U have support, not suport user?

From: Anonymous at: 2011-07-21 09:44:00

It's a miracle! He don't install any linux window manager, and can run an MS windows program.

I hope, You will be  learning more, for example netwrorking, before starting Your sysadmin's life.

From: at: 2011-05-08 12:54:44

I'm a CentOS 5.6 version is used and the description of at least 20 in bad!

By the time I made the installation work properly there is nothing!

this is the whole thing as it is scandalous!

From: at: 2012-01-06 23:54:45

Hello I saw all tutorial step by step, at the end only ispconfig doesn't start.

 I understood that it isn't under init.d ispconfig, so I can't manually start the service.

 Please how can I do?

 thanks in advance