Home / How To / Updating ISPConfig 3.1 to ISPConfig 3.2

Updating ISPConfig 3.1 to ISPConfig 3.2

This tutorial explains the steps that must be taken to update an ISPConfig 3.1 server to ISPConfig 3.2. This tutorial is compatible with CentOS, Debian and Ubuntu operating systems.

See the ISPConfig 3.2 release for a list of new features and additional information about the ISPConfig 3.2 release.

Check ISPConfig 3.2 system requirements

ISPConfig 3.2 is compatible with the following operating system versions:

  • CentOS 7
  • CentOS 8
  • Debian 9
  • Debian 10
  • Ubuntu 16.04 LTS
  • Ubuntu 18.04 LTS
  • Ubuntu 20.04 LTS

Does ISPConfig 3.2 work on older operating systems?

This may work if the installed standard PHP version is mine. PHP 5.4. We did not test older versions and you may need to manually adjust configuration files when they contain settings that are not supported by old software versions that can be used on an unsupported operating system.

Install new program dependencies

Some of the features of ISPConfig 3.2 require additional software. This software should be installed before starting the update.

For Debian and Ubuntu

sudo apt-get install bzip2 p7zip xz-utils lzip rar unrar-free goaccess dovecot-lmtpd

For CentOS 7

sudo yum -y install ncurses-devel gcc geoip-devel tokyocabinet-devel lbzip2 p7zip xz-libs lzip
cd /tmp
wget http://tar.goaccess.io/goaccess-1.4.tar.gz
tar xfz goaccess-1.4.tar.gz
cd goaccess-1.4
sudo ./configure --enable-utf8 --enable-geoip=legacy
sudo make
sudo make install
sudo ln -s /usr/local/bin/goaccess /usr/bin/goaccess

For CentOS 8

dnf install ncurses-devel gcc geoip-devel tokyocabinet-devel lbzip2 p7zip xz-libs lzip
cd /tmp
wget http://tar.goaccess.io/goaccess-1.4.tar.gz
tar xfz goaccess-1.4.tar.gz
cd goaccess-1.4
sudo ./configure --enable-utf8 --enable-geoip=legacy
sudo make
sudo make install
sudo ln -s /usr/local/bin/goaccess /usr/bin/goaccess

CentOS 7 and 8

There is no free raros package for CentOS on centOS or Epel repository, just a trial version from rarlab. If you still want to install it, here are the installation steps. Rar is optional and is used only as an archive option for backing up websites. When you do not install it only works rar as an option for backup format.

cd /tmp
wget https://www.rarlab.com/rar/rarlinux-x64-5.9.1.tar.gz
tar -zxvf rarlinux-x64-5.9.1.tar.gz
cd rar
sudo cp -v rar unrar /usr/local/bin/

Search for custom configuration movie templates

ISPConfig supports custom configuration movie templates stored in the folder / usr / local / ispconfig / server / conf-custom /. If you created some configuration templates there, it is likely that they are not compatible with ISPConfig 3.2. Delete them (recommended) or create new ones based on the configuration files that come with ISPConfig 3.2.

You can check for custom configuration files with these commands:

ls -la /usr/local/ispconfig/server/conf-custom/

If the result is as follows, you have no custom configuration movie templates:

[[email protected] tmp]# ls -la /usr/local/ispconfig/server/conf-custom/
total 8
drwxr-x---.  6 root root   76 Oct  1 00:02 .
drwxr-x---. 13 root root 4096 Oct  1 00:02 ..
-rwxr-x---.  1 root root   45 Oct  1 00:02 empty.dir
drwxr-x---.  2 root root   23 Oct  1 00:02 error
drwxr-x---.  2 root root   23 Oct  1 00:02 index
drwxr-x---.  2 root root   23 Oct  1 00:02 install
drwxr-x---.  2 root root   23 Oct  1 00:02 mail

So there is nothing to do in this case.

Then check the installation folder:

ls -la /usr/local/ispconfig/server/conf-custom/install/

The following results show and even folder without any custom templates:

[[email protected] tmp]# ls -la /usr/local/ispconfig/server/conf-custom/install/
total 4
drwxr-x---. 2 root root 23 Oct  1 00:02 .
drwxr-x---. 6 root root 76 Oct  1 00:02 ..
-rwxr-x---. 1 root root 45 Oct  1 00:02 empty.dir

So no custom templates here that need to be removed or adjusted.

Update ISPConfig 3.1 to 3.2

Now we can start the update process. The update must be run as root user, for Debian, use:

su -

to become a root user.

For CentOS and Ubuntu, use:

sudo -s

to become root.

Then the ISPConfig update is started with the command:


Select “stable“as an update source in the dialog that appears on the screen:

ISPConfig stable updateAdvertisement


Note: available update options vary depending on your old ISPConfig version. But there is always an alternative called stable.

The update process will ask some questions as shown below. I have marked the recommended answers in red.

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

>> Update

Operating System: Ubuntu 20.04.1 LTS (Focal Fossa)

This application will update ISPConfig 3 on your server.

Shall the script create a ISPConfig backup in /var/backup/ now? (yes,no) [yes]: yes

Creating backup of "/usr/local/ispconfig" directory...
Creating backup of "/etc" directory...
Checking ISPConfig database .. OK
Starting incremental database update.
Loading SQL patch file: /tmp/ispconfig3_install/install/sql/incremental/upd_dev_collection.sql
Reconfigure Permissions in master database? (yes,no) [no]: <-- On multiserver systems, choose yes, on single server systems, choose no.

Reconfigure Services? (yes,no,selected) [yes]: yes

Configuring Postfix
Configuring Dovecot
Configuring Mailman
Configuring Spamassassin
Configuring Amavisd
Configuring Getmail
Configuring BIND
Configuring Pureftpd
Configuring Apache
Configuring vlogger
Configuring Apps vhost
Configuring Jailkit
Configuring Ubuntu Firewall
Configuring Database
Updating ISPConfig
ISPConfig Port [8080]: <-- just hit return to accept the default

Create new ISPConfig SSL certificate (yes,no) [no]: <-- Choose no to keep existing SSL cert, choose yes to create new SSL cert or switch from self-signed to a Let's encrypt SSL certificate.

Reconfigure Crontab? (yes,no) [yes]: yes

Updating Crontab
Restarting services ...
Update finished.

Do not worry when you see any other “Configure …” lines, the actual result depends on the software installation on your server.

Need help with the update?

If you need help with the update, if you have further questions about the update process or if you encounter problems after updating your system, please write a post describing the problem in the ISPConfig support forum here at howtoforge:


Do not use the comment feature below this article for individual support questions.

Something went completely wrong and you want to return to the previous installation?

The ISPConfig updater creates a backup of the whole /etc directory (so all your configuration files), the directory / usr / local / ispconfig (entire previous ISPConfig installation) and ISPConfig dbispconfig MySQL / MariaDB database. The backup is in the folder / var / backup / there is a subfolder starting with ‘ispconfi_’ plus the server’s hostname and update date. Example:

[[email protected] ~]# ls /var/backup/

This folder contains backups of files such as tar.gz files and an SQL dump:

[[email protected] ~]# ls /var/backup/ispconfig_server1.example.com_2020-10-15_19-38/
etc.tar.gz  ispconfig_db_backup.sql  ispconfig_software.tar.gz


Source link