Files

T

History

Clément Désiles b94743567f feat(sys_autoupdate): notify on pending kernel reboot

Detect drift between the running kernel and the newest installed one
(Arch: /usr/lib/modules vs uname -r; Debian: /var/run/reboot-required)
and push a weekly ntfy reminder until the host is rebooted.

Also bundles the in-flight ignore-packages feature and hostname
refactor in the autoupdate script.

2026-09-05 16:59:49 +02:00

defaults

feat(sys_autoupdate): notify on pending kernel reboot

2026-09-05 16:59:49 +02:00

handlers

feat: sys autoupdate

2026-05-08 23:47:21 +02:00

README.md

sys_autoupdate

Automated system updates and Podman image updates with ntfy notifications.

Supports Arch Linux and Debian/Ubuntu. Deploys a Bash script + systemd timer that runs daily to:

Check for distro-specific news requiring manual intervention (Arch only)
Apply system updates (pacman -Syu / apt-get dist-upgrade)
Pull latest Podman images and restart pods with updated images
Send push notifications via ntfy.sh at each stage

Configuration

See defaults/main.yml for all variables.

Required in host vars:

sys_autoupdate_ntfy_topic: your-notification-topic

OS support

OS	Update command	News check
Arch Linux	`pacman -Syu --noconfirm`	archlinux.org/news
Debian/Ubuntu	`apt-get dist-upgrade -y`	None (stable release)

OS-specific commands are defined in vars/archlinux.yml and vars/debian.yml, loaded automatically via ansible_facts['os_family'].

Excluding packages from auto-update

Set sys_autoupdate_ignore_packages to a list of package names to hold back. Useful when running out-of-tree kernel modules (ZFS DKMS, Nvidia, VirtualBox) that must stay in lockstep with the kernel.

# Arch with ZFS DKMS
sys_autoupdate_ignore_packages:
  - linux
  - linux-headers
  - zfs-dkms
  - zfs-utils

Translation per OS:

Arch: passed as pacman --ignore=pkg1,pkg2 on each run. Held packages are also filtered out of the pending-update detection.
Debian/Ubuntu: reconciled via apt-mark hold at role-apply time. Holds added by this role are not automatically released when removed from the list — run sudo apt-mark unhold <package> to release them manually.

Warning: when holding the kernel, also hold matching headers and any DKMS modules together. Holding the kernel while letting zfs-dkms advance can break the DKMS build on next boot.

Podman image updates

When sys_autoupdate_podman_enabled: true (default), the script scans podman_projects_dir for docker-compose.yml files, pulls images via podman-compose pull, and recreates containers with podman-compose up -d for projects with updated images. Dangling images are pruned after each run.

The script runs as root (for package management) and uses sudo -u {{ ansible_user }} for Podman operations to preserve rootless isolation.

Notifications

Tag	Meaning
`white_check_mark`	System update succeeded
`x`	Update or pod restart failed
`warning`	Distro news requires manual review (Arch)
`whale`	Podman images updated
`arrows_counterclockwise`	Running kernel older than installed — reboot pending (notified weekly, `sys_autoupdate_reboot_notify_weekday`)