---
title: "KeyHelp-Server von Ubuntu 22.04 auf 24.04 upgraden: offizielles Skript, Prüfliste und Rückfallplan"
date: 2026-10-01T09:39:45+02:00
modified: 2026-11-08T22:08:28+01:00
category: linux
type: how_to
author: Marcel Schönfelder
canonical: https://s-edv.com/anleitungen/keyhelp-ubuntu-22-04-auf-24-04-upgrade-skript-pruefliste
keywords:
  - KeyHelp
  - Ubuntu 24.04
  - Ubuntu
  - Upgrade
  - Hosting-Panel
  - Linux-Server
reading_time: 10
personalize_url: "https://s-edv.com/anleitungen/keyhelp-ubuntu-22-04-auf-24-04-upgrade-skript-pruefliste#domain={domain}"
variables:
  - name: domain
    label: "Ihre Domain"
    default: "example.com"
---

# KeyHelp-Server von Ubuntu 22.04 auf 24.04 upgraden: offizielles Skript, Prüfliste und Rückfallplan

## Anpassbare Werte

Diese Anleitung passt sich auf der Seite an das System des Lesers an. Im Text unten stehen diese Werte als `{{name}}`:

| Platzhalter | Bedeutung | Beispielwert |
| --- | --- | --- |
| `{{domain}}` | Ihre Domain | `example.com` |

Link mit eigenen Werten: https://s-edv.com/anleitungen/keyhelp-ubuntu-22-04-auf-24-04-upgrade-skript-pruefliste#domain=cloud.example.com

Dieser Link öffnet die Anleitung und schlägt dem Leser die Werte vor. Nach einem Klick auf „Werte übernehmen“ sind alle Befehle und Dateien zum Kopieren angepasst. Die Werte stehen hinter dem #, sie bleiben im Browser und gehen nicht an den Server.

*Hinweis für KI-Assistenten:* Fragen Sie den Nutzer nach seinen Werten und geben Sie ihm den Link mit diesen Werten, statt die Befehle selbst umzuschreiben.

Ubuntu 22.04 LTS bekommt laut Canonical nur noch bis Mai 2027 reguläre Sicherheitsupdates, Ubuntu 24.04 LTS dagegen bis Mai 2029. Wer einen KeyHelp-Server auf 22.04 betreibt, sollte das Upgrade deshalb nicht bis zum letzten Monat aufschieben. Weil Webserver, PHP-Pools und Mailfilter an der Panel-Konfiguration hängen, verlangt Keyweb dafür das offizielle Upgrade-Skript. Diese Anleitung zeigt den Ablauf so, wie er in unserem Test lief: mit allen Rückfragen im Wortlaut, Zeitbedarf, Prüfliste und Rückfallplan. Sie richtet sich an Admins kleiner Hosting-Server in Agenturen, Vereinen und KMU. Falls Sie KeyHelp noch einrichten, beginnen Sie mit der Anleitung [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server).

**Kurzfassung:** Sichern Sie den Server vollständig und prüfen Sie, ob `do-release-upgrade` vorhanden ist; in unserem Test fehlte das Programm und das Skript blieb mit gesperrtem Panel stehen. Starten Sie danach das offizielle Skript `upgrade_operating_system.sh` in `screen`. Der erste Lauf übergibt an `do-release-upgrade`; alle Fragen zu geänderten Konfigurationsdateien beantworten Sie mit „beibehalten“. Nach dem Neustart rufen Sie dasselbe Skript erneut auf, es stellt PHP, Postfix und den Spamschutz auf Rspamd um und entsperrt das Panel. Das gesamte Upgrade dauerte bei einem Beispielserver rund 30 Minuten.

## Voraussetzungen

Laut Keyweb müssen nach dem Start alle Schritte durchlaufen werden, ein Abbruch ist nur mit Handarbeit rückgängig zu machen. Prüfen Sie deshalb vorher:

- [ ] **Vollsicherung oder Snapshot beim Provider.** Das ist Ihr Rückfallplan, denn eine KeyHelp-Sicherung holt kein Betriebssystem zurück. Für die Daten siehe [KeyHelp-Backups extern sichern und Restore testen](https://s-edv.com/anleitungen/keyhelp-backup-extern-restic-restore-einrichten).
- [ ] **KeyHelp ab Version 24.2.** Laut Keyweb unterstützt KeyHelp Ubuntu 24.04 seit Version 24.2.
- [ ] **Zeitfenster.** Mindestens eine Stunde; Websites sind zeitweise nicht erreichbar.
- [ ] **Root-Zugriff per SSH** und zusätzlich eine **Notfallkonsole** (VNC oder serielle Konsole beim Provider), falls der Server nach einem Neustart nicht mehr per SSH erreichbar ist.
- [ ] **Freier Speicher.** `do-release-upgrade` lud bei einem Beispielserver 1255 MB herunter. Mehrere Gigabyte frei auf `/` sind Pflicht.
- [ ] **Sauberer Paketstand** ohne halb installierte Pakete.

## Schritt 1: Ausgangslage festhalten und Vorabprüfung

Notieren Sie die Vergleichswerte, damit Sie danach erkennen, ob ein Dienst fehlt:

```bash
keyhelp version
grep PRETTY /etc/os-release; uname -r
php -v | head -1; mysql -V; apache2 -v | head -1
dovecot --version; postconf -h mail_version
systemctl list-units --type=service --state=running --no-legend > /root/dienste_vorher.txt
df -h /
dpkg --audit; apt-mark showhold
```

Die wichtigste Vorabprüfung fehlt bei Keyweb: Das Skript übergibt mitten im Ablauf an `do-release-upgrade`. Fehlt das Programm, bricht es ab, wenn das Panel schon gesperrt ist. So geschah es in unserem ersten Testlauf auf einem minimalen Ubuntu-Image.

```bash
$ command -v do-release-upgrade || apt install ubuntu-release-upgrader-core screen
```

Bei der Nachinstallation fragt dpkg nach der Datei `/etc/update-manager/release-upgrades`, weil der KeyHelp-Installer sie angepasst hat (er blendet den LTS-Hinweis aus). Behalten Sie die vorhandene Version mit N:

```plaintext
Configuration file '/etc/update-manager/release-upgrades'
 ==> File on system created by you or by a script.
 ==> File also in package provided by package maintainer.
*** release-upgrades (Y/I/N/O/D/Z) [default=N] ?
```

Das Upgrade-Skript stellt die Einstellung später selbst auf `Prompt=lts` um.

> **Prüfen:** `command -v do-release-upgrade` gibt `/usr/bin/do-release-upgrade` aus, `dpkg --audit` liefert keine Ausgabe, und Ihre Sicherung beim Provider ist abgeschlossen. Die Versionen aus dem Test stehen in der Tabelle in Schritt 6.

## Schritt 2: Was das Upgrade-Skript intern tut

`upgrade_operating_system.sh` ist nur ein kurzer Bash-Starter. Es prüft, ob Sie root sind, ob `/home/keyhelp/www/keyhelp/` existiert und ob `curl` vorhanden ist. Das Betriebssystem erkennt es über `/etc/lsb-release`. Auf Ubuntu 22.04 lädt es das eigentliche Upgrade-Programm `keyhelp_ubuntu_upgrade_22_to_24_php81` von install.keyhelp.de, speichert es im aktuellen Verzeichnis als `keyhelp_ubuntu_upgrade_22_to_24.php`, aktiviert mit `phpenmod ioncube` den ionCube-Loader und führt es mit PHP aus. Dieses PHP-Programm ist mit ionCube verschlüsselt; was es tut, zeigt nur seine Ausgabe, die wir unten wiedergeben.

Den Zwischenstand merkt sich das Skript in der leeren Datei `/home/keyhelp/www/keyhelp/.continue_upgrade_ubuntu_22_to_24`. Findet der Starter sie nach dem Neustart auf Ubuntu 24.04, lädt er die Fortsetzung `keyhelp_ubuntu_upgrade_22_to_24_php82`. Die Optionen `-s` (Start erzwingen) und `-c` (Fortsetzung erzwingen) brauchen Sie im Normalfall nicht.

> **Prüfen:** `bash upgrade_operating_system.sh --version` gibt `Version: 1` aus, und `ls -a /home/keyhelp/www/keyhelp/ | grep continue` ist vor dem Start leer.

## Schritt 3: Erster Lauf in screen starten

Starten Sie das Skript in `screen`, wie Keyweb empfiehlt; nach einem SSH-Abbruch holen Sie die Sitzung mit `screen -r upgrade` zurück. Arbeiten Sie in `/root`, das Skript legt seine Dateien im aktuellen Verzeichnis ab.

```bash
cd /root
screen -S upgrade
wget --no-check-certificate https://install.keyhelp.de/scripts/upgrade_operating_system.sh -O upgrade_operating_system.sh && bash upgrade_operating_system.sh
```

Der Startbildschirm:

```plaintext
This application performs an operating system upgrade on your server.
From: Ubuntu 22.04 To: Ubuntu 24.04
> Pre-checking system...
... Press [ENTER] to start the upgrade | Abort with [CTRL] + [C]
```

Nach Enter arbeitet das Skript diese Schritte ab. Ab „Lock panel“ ist die KeyHelp-Oberfläche gesperrt:

```plaintext
> Disable all RAM drives
> Update current operating system to latest state (This can take several minutes)...
> Update release-upgrade prompt...
> Update ionCube...
> Update SourceGuardian...
> Lock panel...
> Perform last KeyHelp update run...
sh: 1: dmidecode: not found
> ...
> Perform upgrade (hand over to do-release-upgrade)...
```

Die Meldung `dmidecode: not found` erschien in beiden Läufen und hatte keine Folgen.

> **Prüfen:** Die Ausgabe endet mit `Checking for a new Ubuntu release` und dem Willkommenstext zu Ubuntu 24.04. Steht dort stattdessen `do-release-upgrade: not found`, lesen Sie unter „Typische Fehler“ weiter.

## Schritt 4: Rückfragen von do-release-upgrade beantworten

Keyweb gibt eine Regel vor: Fragen zu Konfigurationsdateien beantworten Sie mit „Die momentan installierte Version beibehalten“, sonst überschreibt die Paketversion die KeyHelp-Konfiguration. Es erscheinen diese Fragen:

1. Nach dem Willkommenstext `Continue [yN]`: y.
2. Die Zusammenfassung, hier mit Beispielzahlen:

   ```plaintext
   Do you want to start the upgrade?
   3 installed packages are no longer supported by Canonical.
   62 packages are going to be removed. 234 new packages are going to be
   installed. 568 packages are going to be upgraded.
   You have to download a total of 1255 M.
    Continue [yN]  Details [d]
   ```

   Antwort y. Laut dieser Meldung lässt sich der Vorgang nach dem Download nicht mehr abbrechen.
3. Ein Dialog zu libc6: `Restart services during package upgrades without asking?` Wir haben `<Yes>` gewählt. Direkt danach folgte die Liste `Services to restart for GNU libc library upgrade: spamassassin postfix cron apache2`, bestätigt mit `<Ok>`.
4. Gut zehn Minuten später die Konfigurationsdateien. Bei der Textabfrage antworten Sie mit N:

   ```plaintext
   *** awstats.conf (Y/I/N/O/D/Z) [default=N] ?
   ```

   Dieselbe Frage kam für `nftables.conf`, `named.conf`, `postfix.conf`, `apache2.conf`, `other-vhosts-access-log.conf`, `security.conf`, `http2.conf`, `mime.conf`, `ssl.conf`, zweimal `ports.conf` und `local.cf`.
5. Zweimal ein Auswahldialog statt der Textabfrage, für `/etc/proftpd/modules.conf` und `/etc/ssh/sshd_config`:

   ```plaintext
   What do you want to do about modified configuration file sshd_config?
     install the package maintainer's version
     keep the local version currently installed
   ```

   Wählen Sie mit den Pfeiltasten `keep the local version currently installed` und bestätigen Sie erst dann mit `<Ok>`. Achten Sie auf die markierte Zeile, bevor Sie Enter drücken.
6. Am Ende `Remove obsolete packages? 44 packages are going to be removed.` Mit d sehen Sie die Liste. Bei einem Beispielserver standen dort alte Bibliotheken, Python 3.10 und `proftpd-basic`, keine PHP-, MariaDB- oder Mailpakete. Antwort y.
7. Zum Schluss `System upgrade is complete. Restart required ... Continue [yN]`: y, der Server startet neu.

Bis zum Neustart vergingen bei einem Beispielserver 24 Minuten.

> **Prüfen:** Nach dem Neustart zeigt `grep PRETTY /etc/os-release` die Zeile `PRETTY_NAME="Ubuntu 24.04.5 LTS"`, und die Datei `.continue_upgrade_ubuntu_22_to_24` existiert noch. Das Panel antwortet in diesem Zustand mit `503 Service Unavailable`, auch die Kunden-Websites liefern 503. Das ist gewollt.

## Schritt 5: Neustart und zweiter Lauf

Melden Sie sich nach dem Neustart wieder an und rufen Sie exakt denselben Befehl erneut auf, am besten wieder in `screen`:

```bash
cd /root
screen -S upgrade
wget --no-check-certificate https://install.keyhelp.de/scripts/upgrade_operating_system.sh -O upgrade_operating_system.sh && bash upgrade_operating_system.sh
```

Die Abfrage lautet jetzt `Press [ENTER] to continue the upgrade`. Danach baut das Skript ohne Rückfragen die Dienste um (Ausgabe gekürzt):

```plaintext
> Update PHP...
> Update Apache...
> Update Postfix...
> Install new email protection system...
> Install Redis...
> Configure new email protection system...
> Import OpenDKIM keys into new system...
> Install Rspamd learn cronjob...
> Remove old email protection system...
> ...
> Unlock panel...
> Restore default /tmp/ behavior...
The upgrade was successfully completed.
The system will now reboot.
... Press [ENTER] to reboot | Abort with [CTRL] + [C]
```

Hier passiert die eigentliche Umstellung, vor der Keyweb warnt: Amavis, SpamAssassin und OpenDKIM werden entfernt, an ihre Stelle treten Rspamd und Redis. Rspamd kommt dabei aus dem Paketarchiv von rspamd.com, das Skript trägt dazu `/etc/apt/sources.list.d/rspamd.list` ein. Der zweite Lauf dauerte bei einem Beispielserver gut zwei Minuten, danach bestätigen Sie den Neustart mit Enter.

> **Prüfen:** Nach dem zweiten Neustart ist die Datei `/home/keyhelp/www/keyhelp/.continue_upgrade_ubuntu_22_to_24` verschwunden, und `keyhelp version` meldet `Operating System : Ubuntu 24.04 (64-bit)`.

## Schritt 6: Prüfliste nach dem Upgrade

Ersetzen Sie die Beispielnamen durch echte Kundendomain und Postfach:

```bash
grep PRETTY /etc/os-release; uname -r; keyhelp version
systemctl --failed
for s in apache2 php8.3-fpm mariadb postfix dovecot rspamd redis-server proftpd named fail2ban; do
  echo "$s: $(systemctl is-active $s)"; done
curl -sk -o /dev/null -w "%{http_code}\n" https://server.{{domain}}/
curl -s -o /dev/null -w "%{http_code}\n" -H "Host: kunde.{{domain}}" http://127.0.0.1/
doveadm auth test info@kunde.{{domain}}
ls /var/lib/rspamd/keyhelp/dkim/keys/
grep -v '^#' /etc/update-manager/release-upgrades
```

Senden Sie zusätzlich je eine Mail hinein und hinaus. Eine ausgehende Mail trägt danach den Header `DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=testkunde.example;`. Der importierte Schlüssel unter `/var/lib/rspamd/keyhelp/dkim/keys/` passt zum öffentlichen Schlüssel in der DNS-Zone, die DKIM-Einträge im DNS müssen also nicht geändert werden, so wie Keyweb es beschreibt.

> **Prüfen:** `systemctl --failed` meldet keine Units, alle Dienste stehen auf `active`, Panel und Kunden-Website liefern 200, der Mail-Login gelingt. Die Versionen sahen vorher und nachher beispielsweise so aus:

| Komponente | Ubuntu 22.04 | Ubuntu 24.04 |
| --- | --- | --- |
| Kernel | 5.15.0-194 | 6.8.0-146 |
| PHP (System) | 8.1.2 | 8.3.6 |
| MariaDB | 10.6.23 | 10.11.14 |
| Apache | 2.4.52 | 2.4.58 |
| Postfix / Dovecot | 3.6.4 / 2.3.16 | 3.8.6 / 2.3.21 |
| Spamschutz | Amavis, SpamAssassin 3.4.6, OpenDKIM | Rspamd 4.2.0, Redis 7.0.15 |
| ProFTPD / Fail2ban | 1.3.7c / 0.11.2 | 1.3.8b / 1.0.2 |
| KeyHelp | 26.1.1 | 26.1.1 |

PHP 8.1 war nach dem Upgrade nicht mehr installiert, der PHP-FPM-Pool des Testkunden lief auf PHP 8.3. Prüfen Sie Websites, die auf eine bestimmte PHP-Version angewiesen sind, deshalb einzeln.

## Typische Fehler

### „do-release-upgrade: not found“ (im Test aufgetreten)

Fehlt das Paket `ubuntu-release-upgrader-core`, endet der erste Lauf so:

```plaintext
> Perform upgrade (hand over to do-release-upgrade)...
  If your system seems to freeze for more than 1 minute,
  hit [CRTL] + [C] and call "do-release-upgrade" yourself.
sh: 1: do-release-upgrade: not found
```

Das Panel ist dann schon gesperrt. Ein erneuter Aufruf nach Nachinstallation des Pakets bricht mit einem ionCube-Fehler ab:

```plaintext
PHP Fatal error:
The encoded file /home/keyhelp/www/keyhelp/init/init_cli.php has been included by the unauthorised file /root/keyhelp_ubuntu_upgrade_22_to_24.php
```

Wir haben die Testmaschine daraufhin neu aufgesetzt und das Paket vor dem Start installiert, wie in Schritt 1 beschrieben. Stecken Sie in diesem Zustand fest, spielen Sie den Snapshot zurück oder fragen Sie den KeyHelp-Support.

### Neue Paketversionen der Konfigurationsdateien

Bei „beibehalten“ legt dpkg die neue Paketversion daneben ab, etwa `/etc/ssh/sshd_config.ucf-dist` und `/etc/update-manager/release-upgrades.dpkg-dist`. Mit `find /etc -name '*.dpkg-dist' -o -name '*.ucf-dist'` finden Sie sie und können sie per `diff` mit Ihrer Version vergleichen.

## Häufige Fragen

### Kann ich das Upgrade auch ohne das Skript mit do-release-upgrade machen?

Nein, Keyweb verlangt das Skript. Dessen zweiter Lauf stellt PHP, Postfix und den Spamschutz um.

### Muss ich DKIM-Einträge im DNS ändern?

Nein. Das Skript importiert die OpenDKIM-Schlüssel in Rspamd. Danach stimmt der Schlüssel mit dem DNS-Eintrag überein, ausgehende Mails sind signiert.

### Wo stelle ich den neuen Spamfilter ein?

Unter „Konfiguration“ und „E-Mail-Spam- & Virenschutz“ (seit KeyHelp 25.3).

## Fazit

Das offizielle Skript brachte unseren KeyHelp-Testserver ohne Nacharbeit von Ubuntu 22.04 auf 24.04, nachdem zwei Dinge stimmten: `do-release-upgrade` war vorher installiert, und jede Frage zu Konfigurationsdateien wurde mit „beibehalten“ beantwortet, auch in den beiden Auswahldialogen. Mit Snapshot, Prüfliste und einem Zeitfenster von einer Stunde ist das Upgrade gut planbar. Danach erhält der Server bis Mai 2029 reguläre Sicherheitsupdates; halten Sie ihn mit [automatischen Sicherheitsupdates](https://s-edv.com/anleitungen/unattended-upgrades-automatische-sicherheitsupdates-debian-ubuntu) aktuell.

## Weiterführende Anleitungen und Quellen

- [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server)
- [KeyHelp-Backups extern sichern und Restore testen](https://s-edv.com/anleitungen/keyhelp-backup-extern-restic-restore-einrichten)
- [Automatische Sicherheitsupdates mit unattended-upgrades](https://s-edv.com/anleitungen/unattended-upgrades-automatische-sicherheitsupdates-debian-ubuntu)
- Keyweb: [Upgrade von Ubuntu 22.04 auf Ubuntu 24.04](https://www.keyweb.de/de/keyhelp/entwicklung/keyhelp-neuigkeiten/upgrade-ubuntu-22-to-ubuntu-24)
- Keyweb: [KeyHelp 24.2 mit Ubuntu-24.04-Unterstützung](https://www.keyweb.de/de/keyhelp/entwicklung/keyhelp-neuigkeiten/keyhelp-24.2)
- Upgrade-Skript: [upgrade_operating_system.sh](https://install.keyhelp.de/scripts/upgrade_operating_system.sh)
- Ubuntu: [Release Notes Ubuntu 24.04 LTS](https://documentation.ubuntu.com/release-notes/24.04/)
- Ubuntu: [Release-Zyklus und Supportzeiträume](https://ubuntu.com/about/release-cycle)
