os-update(8)

📦 version 1.21+git.20241206, in opensuse-leap 16.0

✨ NAME ✨

okay so bestie, this is os-update(8) from the System Manager's Manual — the page for os-update, which is here to Update automatically packages and reboot if necessary. 💅

🌸 SYNOPSIS 🌸

/usr/libexec/os-update
/usr/lib/systemd/system/os-update.service
/usr/lib/systemd/system/os-update.timer

🦋 DESCRIPTION 🦋

os-update runs daily via the os-update.timer systemd timer and updates the system in a defined way. If the updated packages require a reboot, either rebootmgr is notified (if running) or a reboot is done via systemctl reboot. 🔥

The os-update.timer can be configured like any other systemd timer to run at the best fitting time. yes bestie, schedule your glow-up wisely 🫶

It can be configured to do a full system upgrade (e.g. zypper dup for rolling release distributions like openSUSE Tumbleweed), to update only packages (e.g. zypper up for something like SUSE Linux Enterprise) or to apply only security updates (e.g. zypper patch --category security). it's giving options, and we love that for us ✨

💅 CONFIGURATION OPTIONS 💅

  • UPDATE_CMD="auto" — Specifies how to update the system. Valid values are "auto", "dup", "up" and "security". "auto" will select the best fitting command depending on the OS. 👑
  • REBOOT_CMD="auto" — Specifies how the system will be rebooted in case an update requires this. Valid values are "auto", "rebootmgr", "reboot" and "none". "auto" will use rebootmgr if installed and running, else systemctl reboot. "none" will only print an informative message that a reboot is required, but not trigger any. no cap, that last one is very much "look, not touch" 💀
  • RESTART_SERVICES="yes" — Specifies if after a successful update services should automatically restarted, if they are still using old libraries. 🎀
  • IGNORE_SERVICES="" — Specifies a list of services which should be ignored. Means they will neither get restarted nor trigger a reboot, even if they are mentioned in such a list. 🙈
  • IGNORE_SERVICES_FROM_RESTART="dbus dbus-broker" — Specifies a list of services which should not be restarted. 🦋
  • SERVICES_TRIGGERING_SOFT_REBOOT="dbus dbus-broker" — Specifies a list of services which trigger a soft-reboot. If anything else triggers a real reboot, a full reboot is performed. 😭
  • SERVICES_TRIGGERING_REBOOT="" — Specifies a list of services which trigger a full reboot. 🔥
  • LOG_TAG="root" — Specifies a custom log identifier. ⭐

🎀 CONFIGURATION FILES 🎀

  • /usr/share/os-update/os-update.conf — Vendor provided configuration file, contains the defaults. the blueprint, bestie 💖
  • /etc/os-update.conf — Admin provided configuration file, should only contain the variables which were changed by the system administrator compared to the vendor configuration file. keep it cute, keep it minimal 🧚

🔥 SEE ALSO 🔥

go read these too, iykyk 💜

👑 AUTHORS 👑

Thorsten Kukuk — the icon behind this one 🫶

This page's source/version is os-update, dated December 2024, and it's the os-update(8) manual — byeeee, bestie 🌈💋

📦 where this page comes from