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 upgrade the software by yourself and provide you with the required upgrade application 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 upgrade application 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.
1.)
Start the upgrade application with the following command:
wget --no-check-certificate https://install.keyhelp.de/scripts/upgrade_operating_system.sh -O upgrade_operating_system.sh && bash upgrade_operating_system.sh
During the upgrade, you may be asked to restart your server and run the upgrade application again.
Please always use this command to start the upgrade application.
2.)
You are now in the start screen of the application.
After you hit [ENTER], the upgrade application performs all necessary tasks in preparation of the upgrade.
Additional server reboots may be required, perform them when prompted and restart the upgrade application.
3.)
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.
4.)
In the last step, the upgrade application is restarted automatically.
A server reboot reboot may be required, perform it when prompted and restart the upgrade application.
Confirm the continuation of the upgrade with [ENTER].
The upgrade application will now configure the installed services.
Once this process is complete, confirm the restart of the server.
The upgrade is now complete and your server is ready for use.
Congratulations, you now use KeyHelp with Debian 12 “Bookworm”!
