Alle Tutorials
- PC-Hardware
- Proton Drive: Dateien vom Sync ausschließen
- Update von Debian 10 auf Debian 11
- Apache2, PHP 8, MariaDB und phpMyAdmin
- MariaDB-Upgrade auf Debian / Ubuntu
- Certbot: Let's Encrypt (kostenlose SSL-Zertifikate)
- TeamSpeak 3 Server
- Sinusbot
- pgAdmin 4: Setup-Runbook
- Wildcard-SSL mit acme.sh und IONOS-DNS
- unattended-upgrades: automatische Updates für Debian und Ubuntu
Auf dieser Seite
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:
| Teil | Wo | Aufgabe |
|---|---|---|
apt-daily.timer | systemd | lädt zweimal am Tag die Paketlisten neu, mit Zufallsversatz |
apt-daily-upgrade.timer | systemd | startet 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 |
needrestart | eigenes Paket | startet 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-upgradesDie 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-localapt 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 updateAuf 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 updateRepository hinzufügen (Ubuntu)
sudo apt install -y software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt updatePHP mit Versionsnummer installieren
sudo apt install php8.5-fpm php8.5-cli php8.5-mysql php8.5-curlNimm 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 suryAuf 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=amd64o= 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/*ReleaseFü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.
| Quelle | Muster |
|---|---|
| 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 needrestartHier 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.confDie 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.timerDort eintragen:
[Timer]
OnCalendar=
OnCalendar=*-*-* 04:30
RandomizedDelaySec=15mDie 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.timerLä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 rootKommt 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 --debugAuf 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 todayHäufige Probleme
| Symptom | Ursache | Lösung |
|---|---|---|
| Pakete aus Fremdquellen bleiben alt, das Log meldet trotzdem Erfolg | Quelle fehlt in Origins-Pattern | Origin mit apt-cache policy ermitteln, Muster ergänzen, Trockenlauf |
Muster eingetragen, Quelle steht weiter unter Marking not allowed | ein Feld passt nicht, oft der Codename | Release-Datei lesen, bei NodeSource etwa nodistro |
Log: Package … has conffile prompt and needs to be upgraded manually | eine Konfigurationsdatei des Pakets wurde lokal geändert | einmal von Hand sudo apt upgrade, eigene Änderungen künftig in eigene Dateien |
| Neustart kommt einen Tag zu spät | Reboot-Zeit liegt vor dem Upgrade-Lauf | Timer vorziehen oder Reboot-Zeit nach hinten legen |
| Dienste laufen nach Updates mit alten Bibliotheken | needrestart steht auf interaktiv | $nrconf{restart} = 'a'; setzen |
| Keine Mail | kein funktionierender Mailversand | Testmail schicken, Mailserver einrichten |
| Kernel-Update scheitert | /boot ist voll | Remove-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.