Debian 12 auf Debian 13 (Trixie) aktualisieren

Debian 13 „Trixie“ ist die aktuelle stabile Version von Debian. Debian 12 „Bookworm“ erhält noch für eine Übergangszeit Sicherheitsupdates, sollte aber rechtzeitig aktualisiert werden. Diese Anleitung zeigt ein sicheres Upgrade von Debian 12 auf Debian 13 mit Vorbereitung, Durchführung und Kontrolle.

Bevor Sie beginnen

• Snapshot oder Backup: Erstellen Sie unbedingt einen Snapshot Ihres vServers oder ein vollständiges Backup. Geht etwas schief, kehren Sie damit in wenigen Minuten zum alten Stand zurück.
• Wartungsfenster: Planen Sie 30 bis 60 Minuten ein. Dienste werden während des Upgrades neu gestartet.
• Konsole bereithalten: Halten Sie die noVNC-Konsole im Kundencenter bereit. Sollte die Netzwerkverbindung nach dem Neustart nicht funktionieren, erreichen Sie den Server darüber.
• Fremdquellen prüfen: Pakete aus externen Repositories wie Docker, PHP-Paketquellen oder Datenbanken müssen ebenfalls für Debian 13 verfügbar sein.
• Release Notes lesen: Die offiziellen Hinweise finden Sie unter debian.org/releases/trixie/releasenotes.

Schritt 1: Debian 12 vollständig aktualisieren

sudo apt update
sudo apt full-upgrade
sudo apt autoremove --purge
sudo reboot

Prüfen Sie nach dem Neustart die Version:

cat /etc/debian_version

Die Ausgabe sollte mit 12. beginnen.

Schritt 2: Zustand prüfen

Es dürfen keine halb installierten oder zurückgehaltenen Pakete vorhanden sein:

sudo dpkg --audit
apt-mark showhold

Beide Befehle sollten keine Ausgabe liefern. Prüfen Sie außerdem, ob genug Platz frei ist. Für das Upgrade sollten mindestens 5 GB auf / frei sein:

df -h /

Schritt 3: Paketquellen umstellen

Sichern Sie die bestehenden Paketquellen und ersetzen Sie bookworm durch trixie:

sudo cp -a /etc/apt/sources.list /root/sources.list.bookworm 2>/dev/null
sudo cp -a /etc/apt/sources.list.d /root/sources.list.d.bookworm
sudo sed -i 's/bookworm/trixie/g' /etc/apt/sources.list
sudo sed -i 's/bookworm/trixie/g' /etc/apt/sources.list.d/*.list /etc/apt/sources.list.d/*.sources 2>/dev/null

Kontrollieren Sie das Ergebnis:

grep -rh "^deb\|^Suites" /etc/apt/sources.list /etc/apt/sources.list.d/

Bei Fremdquellen, die noch keine Pakete für Trixie anbieten, kommentieren Sie die Zeile vorübergehend mit # aus.

Schritt 4: Upgrade durchführen

Führen Sie das Upgrade am besten in einer screen- oder tmux-Sitzung aus. So läuft es weiter, falls Ihre SSH-Verbindung abbricht:

sudo apt install -y tmux
tmux new -s upgrade

Das Upgrade erfolgt in zwei Stufen:

sudo apt update
sudo apt upgrade --without-new-pkgs
sudo apt full-upgrade

Während des Upgrades erscheinen möglicherweise Fragen:

• Dienste automatisch neu starten? Mit Ja beantworten.
• Geänderte Konfigurationsdatei ersetzen? Haben Sie die Datei selbst angepasst, etwa sshd_config, wählen Sie N (aktuelle Version behalten). Vergleichen Sie danach mit der neuen Version, die als .dpkg-dist abgelegt wird.

Ist die Verbindung abgebrochen, melden Sie sich neu an und holen Sie die Sitzung mit tmux attach -t upgrade zurück.

Schritt 5: Aufräumen und neu starten

sudo apt autoremove --purge
sudo reboot

Schritt 6: Ergebnis prüfen

cat /etc/debian_version
uname -r
systemctl --failed
sudo journalctl -p err -b --no-pager | tail -n 30

Die Version sollte mit 13. beginnen und systemctl --failed keine fehlgeschlagenen Dienste zeigen. Testen Sie Ihre Websites und Anwendungen. Aktivieren Sie zuvor auskommentierte Fremdquellen wieder, sobald sie Pakete für Trixie anbieten.

Übrig gebliebene Konfigurationsdateien finden Sie mit:

sudo find /etc -name '*.dpkg-dist' -o -name '*.dpkg-old' -o -name '*.ucf-dist'

Fehlerbehebung

Nach dem Neustart keine Netzwerkverbindung

Melden Sie sich über die noVNC-Konsole an. Prüfen Sie mit ip a, ob sich der Name der Netzwerkkarte geändert hat, und passen Sie /etc/network/interfaces an.

„The following packages have been kept back“

Führen Sie sudo apt full-upgrade erneut aus. Bleiben Pakete zurück, stammen sie meist aus einer Fremdquelle ohne Trixie-Unterstützung.

Ein Dienst startet nicht mehr

Prüfen Sie mit sudo journalctl -u dienstname -b die Fehlermeldung. Häufig sind veraltete Optionen in einer angepassten Konfigurationsdatei die Ursache.

Zurück zum alten Stand

Lässt sich ein Problem nicht schnell lösen, setzen Sie den vServer auf den Snapshot von vorher zurück. Ein Downgrade von Debian 13 auf 12 ist ohne Snapshot nicht vorgesehen.

Wie Sie Ihren Server nach dem Upgrade automatisch mit Sicherheitsupdates versorgen, zeigt der Artikel Automatische Sicherheitsupdates mit unattended-upgrades.