Upgrade Debian 11 to Debian 12

by Alexander Mahr

Since version 23.2 KeyHelp also supports the operating system Debian 12 "Bookworm".

Do you run KeyHelp on a server with Debian 11 and want to take advantage of the optimized Debian 12? With this guide, we give you the opportunity to update the software by yourself and provide you with the required script and detailed instructions. Please do not hesitate to contact us if you have any questions or need assistance.

Such instructions are also available for the older operating system versions of Debian and Ubuntu.
Further information can be found here.

ATTENTION: After you have started the script and confirmed the start of the upgrade with [ENTER], all the steps described here must be completed. If you cancel the current process, any changes already made must be undone manually.

ATTENTION: An ongoing upgrade process should always be monitored. Please keep the terminal window open for the duration of the upgrade. You should consider running the upgrade using the screen command to prevent the SSH session from being accidentally terminated.

ATTENTION: Although extensively tested, a previous backup of the server should always be performed.

ATTENTION: Additionally installable PHP interpreters are available from PHP 5.6 on. If older PHP interpreters are used on your system, you have to manually change the affected domains to a higher version.

ATTENTION: The package source list (/etc/apt/sources.list) is overwritten during the upgrade. If you have specified your own package sources, you may need to reconfigure them after the upgrade.

ATTENTION:In the course of the upgrade, the previous email protection system, consisting of the components Amavis, SpamAssassin and OpenDKIM, will be replaced by the modern system Rspamd. Please check the proper functioning of the email system after the upgrade.

The DKIM keys of the previous system are seamlessly imported into the new system, so external DNS administrations do not need to be updated in this regard.


Upgrade guide



Download the script with this command:

wget --no-check-certificate -O keyhelp_debian_upgrade_11_to_12.php

Afterwards start script with:

php keyhelp_debian_upgrade_11_to_12.php

You are now in the start screen of the application. After you hit [ENTER], this script performs all necessary tasks in preparation of the upgrade. Additional reboots may be required, perform them when prompted.

The program flow is transferred to the Debian application dist-upgrade. Please follow the instructions of this program. On questions about Should system config files be overwritten? answer with Keep the local version currently installed.

In the last step, the script is restarted automatically. A reboot may be required, perform it when prompted. Confirm the continuation of the upgrade with [ENTER]. The required configuration files will then be updated. Once the process is complete, you will have to confirm the restart of the system. The upgrade is now finished.

Congratulations, you now use KeyHelp with Debian 12 “Bookworm”!