How to Update ISPConfig 3.3.0p3

The ISPConfig update script is an easy way to update an ISPConfig 3 installation. If you want to make a manual backup of ISPConfig, see the instructions at the end of the article. This tutorial applies to ISPConfig 3.2, ISPConfig 3.3, and also ISPConfig 3.3.0p3

To update ISPConfig 3, log in as root user on your server’s shell and run the command:

ispconfig_update.sh

If you want to force an update in case your current version is the same, use –force option.

ispconfig_update.sh --force

For Multiserver setups, it is recommended to enable maintenance mode under System > Interface > Main config in ISPConfig to avoid other users doing changes in ISPConfig while the nodes of the multiserver setup are not in sync.

In the case of a Multiserver setup, update the master server first and then the slave servers.

The update process in detail

ispconfig_update.sh

Update

Please choose the update method. For production systems select ‘stable’.
WARNING: The update from GIT is only for development systems and may break your current setup. Do not use the GIT version on servers that host any live websites!
Note: On Multiserver systems, enable maintenance mode and update your master server first. Then update all slave servers, and disable maintenance mode when all servers are updated.

Select update method (stable,nightly,git-develop) [stable]:

Downloading ISPConfig update.
Unpacking ISPConfig update.

Operating System: Ubuntu 24.04.3 LTS (Noble Numbat)

This application will update ISPConfig 3 on your server.

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

Creating backup of “/usr/local/ispconfig” directory…
Creating backup of “/etc” directory…
Creating backup of “/root/.acme.sh” directory…
Creating backup of “/etc/letsencrypt” directory…
Checking MariaDB version 10.11.13 .. OK
Checking ISPConfig database .. OK
Starting incremental database update.
Loading SQL patch file: /tmp/update_runner.sh.vj8wGKgAHt/install/sql/incremental/upd_0102.sql
Loading SQL patch file: /tmp/update_runner.sh.vj8wGKgAHt/install/sql/incremental/upd_dev_collection.sql
Reconfigure Permissions in master database? (yes,no) [no]:

Service ‘vserver_server’ has not been detected (strongly recommended, currently enabled) do you want to disable it? (yes,no) [yes]:

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

Configuring Postfix
Configuring Dovecot
Configuring Spamassassin
Configuring Rspamd
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]:

Create new ISPConfig SSL certificate (yes,no) [no]:

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

Updating Crontab
Restarting services …
Update finished.

The ISPConfig updater will then update the ispconfig files and restart services, if the configuration has been changed.

Backup before updates

(This backup process is now integrated in the ISPConfig updater and will be executed automatically if you want to create a backup during the update).

Before you update software, it is always a good idea to backup all relevant data. This way you can restore the previous software version in case of an error. How to create a backup copy of the ispconfig software and settings:

Create a backup folder:

mkdir /home/backup
chmod 700 /home/backup
cd /home/backup

Backup the database

mysqldump -u root -p dbispconfig > dbispconfig.sql

Backup the ISPConfig software

tar pcfz ispconfig_software.tar.gz /usr/local/ispconfig

Backup the configuration files in /etc

tar pcfz etc.tar.gz /etc

This backup does not include the emails and website data.