unattended-upgrades: automatische Updates für Debian und Ubuntu

Sicherheitsupdates automatisch einspielen, Fremdquellen wie Sury (PHP), MariaDB oder Docker einbinden, Dienste und Server richtig neu starten und am Ende nachweisen, dass es greift.

unattended-upgrades spielt auf Debian und Ubuntu Updates ein, ohne dass jemand danebensitzt. Einmal am Tag sieht es nach, ob es für die installierten Pakete etwas Neues gibt, und installiert es, wenn die Paketquelle auf seiner Erlaubnisliste steht. Wer einen Server betreibt und nicht jeden Morgen apt upgrade tippen will, kommt daran kaum vorbei.

Eingeschaltet ist es in fünf Minuten. Der Haken liegt im Default: Er erlaubt nur die Quellen der Distribution selbst. PHP von Sury, MariaDB aus dem Herstellerrepo, Node von NodeSource, Docker, all das bekommt keine automatischen Updates. Es gibt dazu weder eine Warnung noch einen Fehler, der Lauf meldet jeden Tag Erfolg. Und gerade diese Pakete hängen meistens direkt am Netz.

In diesem Tutorial richtest Du unattended-upgrades komplett ein, nimmst die Fremdquellen dazu und prüfst am Ende, ob das Ganze auch greift. Die Konfiguration stammt von meinem eigenen Server (Debian 13), und die Fallen weiter unten sind mir dort alle selbst passiert.

Voraussetzungen

  • Debian 12 oder 13, oder Ubuntu 22.04 bzw. 24.04
  • root-Zugang oder ein Benutzer mit sudo
  • für Benachrichtigungen per Mail ein funktionierender Mailversand (etwa exim4 oder Postfix mit Smarthost); ohne geht es auch, dann eben ohne Mail

Wie die Teile zusammenspielen

Die Uhrzeiten und die eigentliche Konfiguration stehen an verschiedenen Stellen, und genau daraus entsteht später eine der Fallen. Deshalb vorab der Überblick:

TeilWoAufgabe
apt-daily.timersystemdlädt zweimal am Tag die Paketlisten neu, mit Zufallsversatz
apt-daily-upgrade.timersystemdstartet den Upgrade-Lauf, im Default um 06:00 plus bis zu 60 Minuten
20auto-upgrades/etc/apt/apt.conf.d/schaltet beides ein
50unattended-upgrades/etc/apt/apt.conf.d/Konfiguration des Pakets, unter anderem die erlaubten Quellen
needrestarteigenes Paketstartet Dienste neu, die eine aktualisierte Bibliothek geladen haben

Ob ein Paket aktualisiert wird, hängt nicht am Paketnamen. Es zählt die Herkunft (der Origin) der Paketquelle. Jede Quelle schreibt in ihre Release-Datei Felder wie Origin, Label und Codename, unattended-upgrades vergleicht sie mit seiner Liste Origins-Pattern, und passt kein Eintrag, wird das Paket übersprungen.

Installieren und einschalten

Auf Ubuntu Server ist das Paket meist schon installiert und aktiv. Auf Debian kommt es darauf an, ob bei der Installation "Sicherheitsaktualisierungen automatisch installieren" gewählt war. Sicherheitshalber:

sudo apt update
sudo apt install unattended-upgrades apt-listchanges
sudo dpkg-reconfigure -plow unattended-upgrades

Die Frage im Dialog beantwortest Du mit "Ja". Danach steht in /etc/apt/apt.conf.d/20auto-upgrades:

APT::Periodic::Update-Package-Lists "1";
APT::Periodic::Unattended-Upgrade "1";

Die 1 heißt: jeden Tag. Ob die beiden Timer laufen, zeigt

systemctl list-timers 'apt-daily*'

Was der Default abdeckt

Auf Debian 13 steht in /etc/apt/apt.conf.d/50unattended-upgrades (ohne die Kommentare):

Unattended-Upgrade::Origins-Pattern {
        "origin=Debian,codename=${distro_codename},label=Debian";
        "origin=Debian,codename=${distro_codename},label=Debian-Security";
        "origin=Debian,codename=${distro_codename}-security,label=Debian-Security";
};

Das sind die Hauptquelle und die Sicherheitsupdates. Die Punktaktualisierungen aus trixie-updates (bzw. bookworm-updates) stehen im Default nur als Kommentar drin. Ubuntu arbeitet mit Allowed-Origins, darin ${distro_id}:${distro_codename}-security und die ESM-Quellen; -updates ist auch dort auskommentiert.

${distro_codename} füllt unattended-upgrades selbst, mit trixie, bookworm, noble und so weiter. Das hat einen angenehmen Nebeneffekt: Nach einem Distributions-Upgrade zeigen die Muster von allein auf die neue Release.

Eine eigene Datei anlegen

Naheliegend wäre, die 50unattended-upgrades direkt zu bearbeiten. Lass das bleiben. Die Datei gehört dem Paket. Ist sie lokal geändert, fragt dpkg beim nächsten Update von unattended-upgrades, ob Du Deine Fassung behalten willst. Im unbeaufsichtigten Lauf beantwortet diese Frage niemand, das Paket wird übersprungen, und ausgerechnet der Updater bleibt auf dem alten Stand.

Leg Deine Einstellungen deshalb in eine eigene Datei, die nach der 50 gelesen wird:

sudo nano /etc/apt/apt.conf.d/52unattended-upgrades-local

apt liest apt.conf.d in alphabetischer Reihenfolge. Bei einzelnen Werten gewinnt die spätere Datei; Listen wie Origins-Pattern werden dagegen angehängt. Die Debian-Einträge aus der 50 gelten also weiter, Deine kommen dazu.

Alle folgenden Abschnitte schreiben in diese eine Datei. Weiter unten steht sie noch einmal am Stück.

Fremdquellen einbinden, am Beispiel Sury

Ondřej Surý betreut die PHP-Pakete in Debian und betreibt daneben ein eigenes Repository mit aktuellen PHP-Versionen (und, wer will, Apache2). Für Debian heißt es packages.sury.org, für Ubuntu ist es die PPA ondrej/php. Sehr viele Server holen ihr PHP von dort, und ohne weitere Einstellung bekommt genau dieses PHP keine Sicherheitsupdates.

Repository hinzufügen (Debian)

Das ist der Ablauf aus der offiziellen Anleitung auf packages.sury.org, nur im deb822-Format, das Debian 13 inzwischen selbst verwendet:

sudo apt install -y ca-certificates curl
curl -fsSLo /tmp/debsuryorg-archive-keyring.deb https://packages.sury.org/debsuryorg-archive-keyring.deb
sudo dpkg -i /tmp/debsuryorg-archive-keyring.deb
 
. /etc/os-release
sudo tee /etc/apt/sources.list.d/php.sources > /dev/null <<EOF
Types: deb
URIs: https://packages.sury.org/php/
Suites: ${VERSION_CODENAME}
Components: main
Signed-By: /usr/share/keyrings/debsuryorg-archive-keyring.gpg
EOF
 
sudo apt update

Auf Debian 12 geht das genauso. Wer die alte Einzeilenform lieber mag:

echo "deb [signed-by=/usr/share/keyrings/debsuryorg-archive-keyring.gpg] https://packages.sury.org/php/ $(. /etc/os-release && echo $VERSION_CODENAME) main" \
  | sudo tee /etc/apt/sources.list.d/php.list
sudo apt update

Repository hinzufügen (Ubuntu)

sudo apt install -y software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update

PHP mit Versionsnummer installieren

sudo apt install php8.5-fpm php8.5-cli php8.5-mysql php8.5-curl

Nimm die Pakete mit Versionsnummer (php8.5-fpm) und nicht die ohne (php-fpm). Die Pakete ohne Nummer sind Metapakete, die bei Sury immer auf die neueste PHP-Version zeigen. Wer sie installiert hat, bekommt mit einem späteren Update unter Umständen eine neue PHP-Hauptversion dazu, und so etwas sollte kein nächtlicher Lauf entscheiden. Mit Versionsnummer bleibt es bei Sicherheits- und Fehlerkorrekturen innerhalb von 8.5.

Den Origin herausfinden

Welche Felder eine Quelle mitbringt, zeigt apt-cache policy, und zwar ohne Paketnamen. Mit Paketnamen fehlen genau die Zeilen, um die es hier geht.

LC_ALL=C apt-cache policy | grep -A1 sury

Auf meinem Server sieht das so aus:

 500 https://packages.sury.org/php trixie/main amd64 Packages
     release o=deb.sury.org,a=trixie,n=trixie,c=main,b=amd64

o= ist der Origin, n= der Codename, a= die Suite und l= das Label (Sury setzt keins). Alternativ liest Du die Release-Dateien direkt:

grep -h -E "^(Origin|Label|Suite|Codename):" /var/lib/apt/lists/*Release

Für Sury heißt der Origin auf Debian deb.sury.org, beim PHP- wie beim Apache2-Repo. Auf Ubuntu sind es LP-PPA-ondrej-php und LP-PPA-ondrej-apache2.

Das Muster eintragen

In die 52unattended-upgrades-local (Debian):

Unattended-Upgrade::Origins-Pattern {
        // Debian-Punktaktualisierungen, im Default auskommentiert
        "origin=Debian,codename=${distro_codename}-updates,label=Debian";
 
        // PHP (und ggf. Apache2) von Sury
        "origin=deb.sury.org,codename=${distro_codename}";
};

Auf Ubuntu:

Unattended-Upgrade::Origins-Pattern {
        "origin=LP-PPA-ondrej-php,codename=${distro_codename}";
        // nur falls die Apache2-PPA eingebunden ist
        "origin=LP-PPA-ondrej-apache2,codename=${distro_codename}";
};

Ein Muster kann die Schlüssel origin, label, codename, archive (die Suite), component und site (Hostname der Quelle) enthalten. Stehen mehrere in einem Eintrag, müssen alle passen.

Weitere häufige Quellen

Die Werte stammen von meinem Debian-Server. Prüf sie trotzdem mit apt-cache policy, bevor Du sie übernimmst: Die Anbieter können ihre Release-Dateien jederzeit ändern.

QuelleMuster
MariaDB (dlm.mariadb.com)"origin=MariaDB,codename=${distro_codename}";
PostgreSQL (apt.postgresql.org)"origin=apt.postgresql.org,codename=${distro_codename}-pgdg";
Docker CE"origin=Docker,label=Docker CE";
Node.js (NodeSource)"site=deb.nodesource.com";
pgAdmin 4"origin=pgAdmin Development Team";

Zwei davon sind eigenwillig. NodeSource trägt als Origin wörtlich . nodistro ein (mit Punkt und Leerzeichen) und als Codename nodistro. Wer dort aus Gewohnheit ${distro_codename} einsetzt, baut ein Muster, das nie etwas trifft; mit site= ist man auf der sicheren Seite. Docker hat überhaupt keinen Codenamen, deshalb das Label.

Einzelne Pakete ausnehmen

Soll eine Quelle grundsätzlich drin sein, ein bestimmtes Paket daraus aber nicht, gibt es die Blacklist. Die Einträge sind reguläre Ausdrücke und passen auf den Anfang des Paketnamens:

Unattended-Upgrade::Package-Blacklist {
        "mariadb-server";
        // alles, was mit docker-ce beginnt
        "docker-ce";
};

Dienste neu starten mit needrestart

Ein Update tauscht die Datei auf der Platte aus. Ein laufender Dienst hat aber noch die alte Bibliothek im Speicher: Ein gepatchtes libssl3 wirkt für Apache erst, wenn Apache neu startet. Darum kümmert sich needrestart, wenn es richtig eingestellt ist.

sudo apt install needrestart

Hier wartet die nächste stille Falle. $nrconf{restart} steht im Default auf 'i', interaktiv, und needrestart fragt dann, welche Dienste neu starten sollen. Im unbeaufsichtigten Lauf ist niemand da, der antwortet. Es passiert also einfach nichts: Das Paket ist aktualisiert, der Lauf meldet Erfolg, und Apache arbeitet weiter mit der alten Bibliothek. Je nach Version und Distribution kann der Default anders aussehen. Verlass Dich nicht darauf und setz den Wert selbst:

sudo tee /etc/needrestart/conf.d/99-local-restart.conf > /dev/null <<'EOF'
# Betroffene Dienste automatisch neu starten
$nrconf{restart} = 'a';
 
# Kernel-Hinweise nicht über needrestart, das übernimmt Automatic-Reboot
$nrconf{kernelhints} = 0;
 
1;
EOF
sudo perl -c /etc/needrestart/conf.d/99-local-restart.conf

Die Datei ist Perl, daher die Prüfung mit perl -c. Die 1; am Ende muss stehen bleiben.

Neustart nach Kernel-Updates

Einen neuen Kernel lädt kein Dienstneustart, dafür braucht es einen Reboot. Nach Kernel- und libc-Updates legt apt die Datei /var/run/reboot-required an, und unattended-upgrades kann den Server dann selbst neu starten:

Unattended-Upgrade::Automatic-Reboot "true";
Unattended-Upgrade::Automatic-Reboot-WithUsers "true";
Unattended-Upgrade::Automatic-Reboot-Time "05:30";

Ohne diese Zeilen liegt der gepatchte Kernel beliebig lange ungenutzt auf der Platte, während jede Prüfung meldet, das System sei aktuell. Automatic-Reboot-WithUsers steht auf true, damit eine vergessene SSH-Sitzung den Neustart nicht verhindert.

Die Uhrzeit muss nach dem Upgrade-Lauf liegen

Diese Falle hat mich selbst erwischt. unattended-upgrades startet den Server nicht selbst neu, es ruft /sbin/shutdown -r 05:30 auf, und für systemd ist das immer die nächste 05:30. Der Upgrade-Lauf beginnt im Default um 06:00 mit bis zu 60 Minuten Zufallsversatz. Um diese Zeit ist 05:30 längst vorbei, also landet der Neustart auf dem Folgetag. Der Kernel läuft fast einen ganzen Tag ungepatcht weiter, obwohl ein Neustartfenster eingestellt ist.

Du kannst die Reboot-Zeit hinter das Fenster legen (zum Beispiel 07:30) oder den Upgrade-Lauf vorziehen. Für die zweite Variante:

sudo systemctl edit apt-daily-upgrade.timer

Dort eintragen:

[Timer]
OnCalendar=
OnCalendar=*-*-* 04:30
RandomizedDelaySec=15m

Die leere OnCalendar=-Zeile muss sein. OnCalendar ist eine Liste, und ohne das Zurücksetzen käme 04:30 zusätzlich zu 06:00 dazu. Danach:

sudo systemctl daemon-reload
sudo systemctl restart apt-daily-upgrade.timer
systemctl list-timers apt-daily-upgrade.timer

Läuft nachts noch etwas anderes, ein Backup zum Beispiel, leg den Neustart so, dass er nichts davon mittendrin trifft.

Benachrichtigung per Mail

Unattended-Upgrade::Mail "root";
Unattended-Upgrade::MailReport "on-change";

Statt root geht auch eine Mailadresse. MailReport kennt drei Werte: always schickt jeden Tag eine Mail, only-on-error nur bei Fehlern und on-change immer dann, wenn tatsächlich etwas installiert wurde oder schiefging. Ich nutze on-change. An ruhigen Tagen kommt nichts, und wenn sich das System verändert hat, will ich es wissen.

Verschickt wird über /usr/sbin/sendmail, das jeder Mailserver mitbringt, ersatzweise über /usr/bin/mail. Bevor Du Dich darauf verlässt, schick eine Testmail:

printf "Subject: Testmail vom Server\n\nTest\n" | sudo /usr/sbin/sendmail root

Kommt die nicht an, kommt auch der Bericht von unattended-upgrades nicht an.

Aufräumen

Unattended-Upgrade::Remove-Unused-Kernel-Packages "true";
Unattended-Upgrade::Remove-New-Unused-Dependencies "true";
Unattended-Upgrade::Remove-Unused-Dependencies "false";

Alte Kernel zu entfernen ist vor allem wichtig, wenn /boot eine eigene, kleine Partition hat. Läuft sie voll, scheitert das nächste Kernel-Update, und das auch noch unbeaufsichtigt. Remove-Unused-Dependencies bleibt aus, weil es auch Pakete entfernt, die Du von Hand installiert hast und die gerade nur zufällig nichts mehr braucht.

Die komplette Datei

So sieht /etc/apt/apt.conf.d/52unattended-upgrades-local für einen Debian-Server mit PHP von Sury und MariaDB aus:

// Ergänzungen zu 50unattended-upgrades. Listen werden angehängt,
// die Debian-Einträge aus der 50 bleiben gültig.
 
Unattended-Upgrade::Origins-Pattern {
        "origin=Debian,codename=${distro_codename}-updates,label=Debian";
        "origin=deb.sury.org,codename=${distro_codename}";
        "origin=MariaDB,codename=${distro_codename}";
};
 
// Bericht nur, wenn sich etwas geändert hat oder etwas schiefging
Unattended-Upgrade::Mail "root";
Unattended-Upgrade::MailReport "on-change";
 
// Neustart nur, wenn /var/run/reboot-required existiert.
// Der Upgrade-Lauf ist per Timer-Override auf 04:30 vorgezogen.
Unattended-Upgrade::Automatic-Reboot "true";
Unattended-Upgrade::Automatic-Reboot-WithUsers "true";
Unattended-Upgrade::Automatic-Reboot-Time "05:30";
 
// Aufräumen
Unattended-Upgrade::Remove-Unused-Kernel-Packages "true";
Unattended-Upgrade::Remove-New-Unused-Dependencies "true";
Unattended-Upgrade::Remove-Unused-Dependencies "false";
 
// In kleinen Schritten, damit ein Abbruch kein halbes System hinterlässt
Unattended-Upgrade::MinimalSteps "true";
Unattended-Upgrade::SyslogEnable "true";
Acquire::Retries "3";
 
// Pakete vorab laden, Paketarchiv wöchentlich leeren
APT::Periodic::Download-Upgradeable-Packages "1";
APT::Periodic::AutocleanInterval "7";

Syntax prüfen, bevor die Datei scharf wird

Ein Tippfehler in einer Datei unter apt.conf.d legt jeden apt-Aufruf lahm, auch den, mit dem Du ihn reparieren willst. Schreib die Datei deshalb zuerst nach /tmp und prüf sie dort:

apt-config dump -c /tmp/52unattended-upgrades-local > /dev/null && echo "Syntax ok"
sudo install -m 644 /tmp/52unattended-upgrades-local /etc/apt/apt.conf.d/

Ob die Listen richtig zusammengeführt wurden:

apt-config dump | grep "Origins-Pattern::"

Prüfen, ob es wirklich greift

Die Konfiguration anzuschauen beweist nichts, ein falsches Muster sieht genauso aus wie ein richtiges. Aussagekräftig ist erst der Trockenlauf:

sudo unattended-upgrade --dry-run --debug

Auf einem deutsch eingestellten System ist die Ausgabe teilweise übersetzt ("Erlaubte Ursprünge sind" statt "Allowed origins are"). Für die beiden folgenden Filter deshalb LC_ALL=C davorsetzen:

# Welche Muster wurden gelesen?
sudo LC_ALL=C unattended-upgrade --dry-run --debug 2>&1 | grep "Allowed origins"
 
# Welche Quellen sind ausgeschlossen?
sudo LC_ALL=C unattended-upgrade --dry-run --debug 2>&1 | grep "Marking not allowed"

Die erste Zeile zeigt nur, dass Deine Datei gelesen wurde. Ehrlich ist erst die zweite: Jede Quelle, die dort mit dem Pin -32768 auftaucht, wird nicht aktualisiert. Erscheint Sury dort nicht mehr, greift das Muster. Steht dort eine Quelle, die Du eigentlich dabeihaben wolltest, passt ein Feld im Muster nicht. Bleibt die zweite Abfrage ganz leer, ist jede Quelle abgedeckt.

Nach dem ersten echten Lauf lohnt ein Blick in die Logs:

sudo less /var/log/unattended-upgrades/unattended-upgrades.log
sudo less /var/log/unattended-upgrades/unattended-upgrades-dpkg.log
journalctl -u apt-daily-upgrade.service --since today

Häufige Probleme

SymptomUrsacheLösung
Pakete aus Fremdquellen bleiben alt, das Log meldet trotzdem ErfolgQuelle fehlt in Origins-PatternOrigin mit apt-cache policy ermitteln, Muster ergänzen, Trockenlauf
Muster eingetragen, Quelle steht weiter unter Marking not allowedein Feld passt nicht, oft der CodenameRelease-Datei lesen, bei NodeSource etwa nodistro
Log: Package … has conffile prompt and needs to be upgraded manuallyeine Konfigurationsdatei des Pakets wurde lokal geänderteinmal von Hand sudo apt upgrade, eigene Änderungen künftig in eigene Dateien
Neustart kommt einen Tag zu spätReboot-Zeit liegt vor dem Upgrade-LaufTimer vorziehen oder Reboot-Zeit nach hinten legen
Dienste laufen nach Updates mit alten Bibliothekenneedrestart steht auf interaktiv$nrconf{restart} = 'a'; setzen
Keine Mailkein funktionierender MailversandTestmail schicken, Mailserver einrichten
Kernel-Update scheitert/boot ist vollRemove-Unused-Kernel-Packages, einmalig sudo apt autoremove --purge

Nach einem Distributions-Upgrade

Muster mit ${distro_codename} gehen beim Upgrade von selbst mit. Steht irgendwo ein fester Name wie bookworm, greift dieser Eintrag danach ins Leere. Dazu kommt, dass nicht jede Fremdquelle die neue Release vom ersten Tag an führt; das Tools-Repo von MariaDB hat zum Beispiel (Stand November 2026) keine trixie-Suite. Nach jedem Upgrade also den Trockenlauf wiederholen und Marking not allowed prüfen.