There is a new revision of this tutorial available for Ubuntu 15.04 (Vivid Vervet).

The Perfect Server - Ubuntu 14.04 (nginx, BIND, MySQL, PHP, Postfix, Dovecot and ISPConfig 3)

This tutorial shows how to prepare an Ubuntu 14.04 (Trusty Tahr) server (with nginx, BIND, Dovecot) for the installation of ISPConfig 3, and how to install ISPConfig 3. ISPConfig 3 is a web hosting control panel that allows you to configure the following services through a web browser: Apache or nginx web server, Postfix mail server, Courier or Dovecot IMAP/POP3 server, MySQL, BIND or MyDNS nameserver, PureFTPd, SpamAssassin, ClamAV, and many more. This setup covers nginx (instead of Apache), BIND (instead of MyDNS), and Dovecot (instead of Courier).

If you want to use nginx instead of Apache with ISPConfig, please note that your nginx version must be at least 0.8.21, and you must install PHP-FPM as well. For CGI/Perl support, you must use fcgiwrap. This is all covered by this tutorial.

Please note that you cannot use this tutorial for Debian Squeeze because Squeeze comes with an older nginx version (0.7.67.) and does not have a PHP-FPM package!

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 The Base System

Insert your Ubuntu install CD into your system and boot from it. Select your language:

Then select Install Ubuntu Server:

Choose your language again (?):

Then select your location:

I will continue here as India location, configure keyboard as No &  I select English(US) here: 

The installer checks the installation CD, your hardware, and configures the network with DHCP if there is a DHCP server in the network: 

Enter the hostname. In this example, my system is called, so I enter server1:

Create a user, for example the user Administrator with the user name administrator (don't use the user name admin as it is a reserved name on Ubuntu 14.04):

Share this page:

15 Comment(s)

Add comment


From: Pete Williams

I found another solution to the 502 error when attempting to access ISPConfig when using nginx.  I used the instructions here:

The issue is related to PHP update to mitigate security risk per this page:
  1. Open /etc/php5/fpm/pool.d/www.conf
  2. Remove comment prefix # from all permission lines, like:

    listen.owner = www-data = www-data

    listen.mode = 0660
  3. Restart fpm - sudo service php5-fpm restart


From: Killozap

You will get a error-message at first when trying to start the admin-page of ispconfig, don't try to use the changes in one comment here, only restart your server and it works!

 When you do the mentioned changes here, it wors, and after the next restart, it will not function anymore.


I have created an ansible script does steps 8 and further in this howto on a clean ubuntu machine. Steps 1-7 are about providing the clean ubuntu machine.


From: Mario

I followed the guide installing on a Microsoft Azure server without getting any problem.I get a strange error : i cannot list directories when i connect by FTP, i get a timeout of 20 seconds.I've tested connecting in Google Chrome and the problem is still there.How to fix?

From: lolo888

For cgi-bin/mailman > error 403 >,227508,227548#msg-227548

put "include /etc/nginx/fastcgi_params;"


fastcgi_intercept_errors on;


From: Andre


I have a lots of errors (Ubuntu 14.04.2,


I need to do this for pure-ftpd:

echo 'yes' > Daemonizeecho 'yes' > VerboseLogecho ,21 > Bindecho 50100 50200 > PassivePortRangeecho 1000 > MaxClientsPerIPecho 1000 > MaxClientsNumberecho yes > NoAnonymous


This allows me to sent magento files to the server. Still there were couple (300+) failed transfers.


I can create user, but he is not appeared when I creating database and moreover I can create database even I have not defined a user. Magento fail to install :(


Only this config allows me to run (not to complete install) of magento:

  location / {    index index.html index.php; ## Allow a static html file to be shown first    try_files $uri $uri/ @handler; ## If missing pass the URI to Magento's front handler    expires 30d; ## Assume all files are cachable  }    ## These locations would be hidden by .htaccess normally  location /app/                { deny all; }  location /includes/           { deny all; }  location /lib/                { deny all; }  location /media/downloadable/ { deny all; }  location /pkginfo/            { deny all; }  location /report/config.xml   { deny all; }  location /var/                { deny all; }

  ##  location /var/export/ { ## Allow admins only to view export folder    auth_basic           "Restricted"; ## Message shown in login window    auth_basic_user_file /home/lumz/public_html/.htpasswd; ## See /etc/nginx/htpassword    autoindex            on;  }   ## Disable .htaccess and other hidden files  location ~ /\. {    deny all;    access_log off;    log_not_found off;  }  location @handler { ## Magento uses a common front handler    rewrite / /index.php;  }    location ~ .php/ { ## Forward paths like /js/index.php/x.js to relevant handler    rewrite ^(.*.php)/ $1 last;  }

   # pass the PHP scripts to FastCGI server listening on # # NOTE: You should have "cgi.fix_pathinfo = 0;" in php.ini location ~ .php$ {    if (!-e $request_filename) { rewrite / /index.php last; } ## Catch 404s that try_files miss    expires        off; ## Do not cache dynamic content

    fastcgi_pass   unix:/var/run/php5-fpm.sock;    fastcgi_param GATEWAY_INTERFACE CGI/1.1;    fastcgi_param SERVER_SOFTWARE nginx;    fastcgi_param DOCUMENT_ROOT /home/lumz/public_html;   fastcgi_param QUERY_STRING $query_string;   fastcgi_param REQUEST_METHOD $request_method;   fastcgi_param CONTENT_TYPE $content_type;   fastcgi_param CONTENT_LENGTH $content_length;   fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;   fastcgi_param SCRIPT_NAME $fastcgi_script_name;   fastcgi_param REQUEST_URI $request_uri;   fastcgi_param DOCUMENT_URI $document_uri;   fastcgi_param SERVER_PROTOCOL $server_protocol;   fastcgi_param REMOTE_ADDR $remote_addr;   fastcgi_param REMOTE_PORT $remote_port;   fastcgi_param SERVER_ADDR $server_addr;   fastcgi_param SERVER_PORT $server_port;   fastcgi_param SERVER_NAME $server_name;   fastcgi_param HTTPS $https;    fastcgi_param  MAGE_RUN_CODE default; ## Store code is defined in administration > Configuration > Manage Stores    fastcgi_param  MAGE_RUN_TYPE store;    include        /etc/nginx/fastcgi_params; ## See /etc/nginx/fastcgi_params }


Database user solution? Anyone?

Thank you.



From: till

I installed the same tutorial today for a customer without any changes and it works fine, no issues at all.


The pure-ftpd things that you describe are only required if you block ports with a firewall. 


The magento config that you posted is not fully compatible with ispconfig as you try to override the php setup so that all php files run under a wrong owner and you refernce directries like /home/... which are outside of the website.So remove the php config and set the corrcet path to the auth file.


Regarding saabase user: a database user gets created when you create the first database for it. Creating a mysql user when there is no database that it can be used for makes no sense and therefor it gets created together with the databse.

From: JamesB

service networking restart does not work in Ubuntu 14.04 and according to official Ubuntu documents the correct method for reseting networking connections in Ubuntu 14.04 is using ifdown <interface> followed by ifup <interface>.

From: alioune9

 je n'arrive pas à acceder à ispconfig

message apache :AH00548 : NameVirtualHost has no effect and will be removed in the next release  /etc/apache2/sites-enbled/000-ispconfig.conf:62

error.log de apache

[Thu Apr 30 10:13:58.191862 2015] [mpm_prefork:notice] [pid 11687] AH00169: caught SIGTERM, shutting down[Thu Apr 30 10:13:59.201576 2015] [ssl:warn] [pid 12291] AH01906: RSA server certificate is a CA certificate (BasicConstraints: CA == TRUE !?)[Thu Apr 30 10:13:59.201635 2015] [ssl:warn] [pid 12291] AH01909: RSA certificate configured for does NOT include an ID which matches the server name[Thu Apr 30 10:13:59.201760 2015] [suexec:notice] [pid 12291] AH01232: suEXEC mechanism enabled (wrapper: /usr/lib/apache2/suexec)[Thu Apr 30 10:13:59.212497 2015] [auth_digest:notice] [pid 12293] AH01757: generating secret for digest authentication ...[Thu Apr 30 10:13:59.226996 2015] [ssl:warn] [pid 12293] AH01906: RSA server certificate is a CA certificate (BasicConstraints: CA == TRUE !?)[Thu Apr 30 10:13:59.227017 2015] [ssl:warn] [pid 12293] AH01909: RSA certificate configured for does NOT include an ID which matches the server name[Thu Apr 30 10:13:59.229142 2015] [mpm_prefork:notice] [pid 12293] AH00163: Apache/2.4.7 (Ubuntu) PHP/5.5.9-1ubuntu4.9 OpenSSL/1.0.1f configured -- resuming normal operations[Thu Apr 30 10:13:59.229173 2015] [core:notice] [pid 12293] AH00094: Command line: '/usr/sbin/apache2'

From: Fabienne

Hello, I installed my server with your tutorial and everything works perfectly. Thank you!

I just have one problem with squirrelmail. Whenever I send a mail, create an folder or delete one, I get a 500 error from nginx.

The logs: [error] 4416#0: *193 rewrite or internal redirection cycle while internally redirecting to "/error/404.html"

The folders are created or deleted, the mails get sent, but I always first have this error message, reloading the page makes it disappear.

Could you please help?

Thank you

From: Ken

Would you please provide a step by step guide for how to use the ansible script?

I got the error...

debug1: Authentications that can continue: publickey,password debug1: Trying private key: /root/.ssh/id_dsa debug3: no such identity: /root/.ssh/id_dsa: No such file or directory debug1: Trying private key: /root/.ssh/id_ecdsa debug3: no such identity: /root/.ssh/id_ecdsa: No such file or directory debug1: Trying private key: /root/.ssh/id_ed25519 debug3: no such identity: /root/.ssh/id_ed25519: No such file or directory debug2: we did not send a packet, disable method debug1: No more authentication methods to try.

Permission denied (publickey,password). 

From: DDArt

Will there be a tutorial on the 15.x Ubuntu or can we use the Ubuntu 15.x Apache Tutorial but just install NGINX instead of Apache and it should work.  Thanks,


From: till

There will be a tutorial for 15.04. Using the apache guide will probably not work.

From: Agustin

Perfect John!!!!


From: Yugo Pangestu

Thank you very much .. post your very nice and complete. just a pity that there is an error at the end of nginx. and thanks also to John Kounis already helped to resolve problems over the past ..