Black screen or SDDM login loop after an update: NVIDIA DKMS failed, so nvidia is missing from the initramfs/UKI
Confirmed on this machine (omarchy-settings 4.0.2-1, limine-mkinitcpio-hook 1.37.1-1, mkinitcpio 41.1-1, nvidia-open-dkms 610.57.04-1): /etc/mkinitcpio.conf.d/nvidia.conf is exactly MODULES+=(nvidia nvidia_modeset nvidia_uvm nvidia_drm), /etc/modprobe.d/nvidia.conf is options nvidia_drm modeset=1, and both match install/hardware/nvidia.sh fetched from quattro. /etc/mkinitcpio.conf.d/omarchy_hooks.conf (owned by omarchy-settings) drops the kms hook only when nvidia_drm is in MODULES and every PCI class 0x03 device has vendor 0x10de, which is the case here (single RTX 3090). /usr/bin/limine-mkinitcpio exists and runs echo rebuild | /usr/share/libalpm/scripts/limine-mkinitcpio-install, whose error text is verbatim 'mkinitcpio failed for kernel X, skipping.' and which returns before limine-entry-tool --add-uki, so the old UKI stays. /usr/bin/mkinitcpio exits !!_builderrors (line 1238) and 'module not found' is an error() in /usr/lib/initcpio/functions:740 that counts, so the exit code claim holds. /etc/mkinitcpio.d is empty on Omarchy 4 because /etc/pacman.d/hooks/90-mkinitcpio-install.hook shadows the stock hook that would write linux.preset, so mkinitcpio -P dies with 'No presets found' (mkinitcpio:986): the wrapper-only claim holds and is stronger than stated. The ALPM guard (/usr/share/omarchy/bin/omarchy-update-pacman-guard) trips only when -S and -u are both present, so pacman -S --needed linux-headers passes. Issue 5706 (open, labels bug and nvidia) supports every element of the cause: DKMS built for the running kernel but not the new ones, UKI rebuild skipped, pacman exit 0, stale UKI with old module, initEGL abort, SDDM loop. What the record misses is WHY the in-place modprobe recovery works: Omarchy 4 installs kernel-modules-hook (line 66 of /usr/share/omarchy/install/omarchy-base.packages, installed 0.1.7-3 here), whose 10-linux-modules-pre/post alpm hooks rsync the running kernel's module tree, including build/ and updates/dkms/, around the transaction, so DKMS can build the new driver for the running kernel and modprobe can load it. On plain Arch without that package the kernel upgrade deletes /usr/lib/modules/$(uname -r), so the record's modprobe -r then modprobe nvidia_drm fails with 'Module nvidia_drm not found' and leaves no driver loaded at all. The reload also only helps when dkms status shows the new driver installed for $(uname -r), which the record never checks. Fix rewritten to gate the reload on that and to label the Omarchy versus plain Arch branch. Symptom transcript path updated: hook 1.37.1-1 builds to /tmp/limine-mkinitcpio.XXXXXX/<kernel>.efi, not /tmp/staging_uki.efi (that was an older hook, quoted from the May 2026 issue). Cause reordered so the Omarchy-typical trigger (driver does not build against the new kernel) comes first, since nvidia.sh already installs the headers. NOT exercised: no DKMS failure was induced, no reboot, no VM run, and dkms autoinstall -k was not executed. The kernel-modules-hook interaction with the dkms upgrade hook is read from the hook files, not observed.
Do not reboot while the transcript says mkinitcpio failed for kernel ..., skipping. The boot image on the ESP is stale and may be the last working one. Never fix this with pacman -Sy nvidia-utils: that is a partial upgrade and will make the mismatch worse. modprobe -r nvidia* kills anything using the GPU, so save work first.
Symptom
After omarchy update (or pacman -Syu) and a reboot the machine goes to a black screen after the boot menu, or SDDM takes the password and bounces straight back to the login screen with no error. Scrolling back through the update transcript shows:
Error! Bad return status for module build on kernel: 7.0.3-arch1-2 (x86_64)
Consult /var/lib/dkms/nvidia-open/595.71.05/build/make.log for more information.
...
==> ERROR: module not found: 'nvidia'
==> ERROR: module not found: 'nvidia_modeset'
==> ERROR: module not found: 'nvidia_uvm'
==> ERROR: module not found: 'nvidia_drm'
==> WARNING: errors were encountered during the build. The image may not be complete.
==> Creating unified kernel image: '/tmp/limine-mkinitcpio.XXXXXX/linux.efi'
==> Unified kernel image generation successful
ERROR: mkinitcpio failed for kernel 7.0.3-arch1-2, skipping.
(Older versions of limine-mkinitcpio-hook printed the staging path as /tmp/staging_uki.efi. The skipping line is the one that matters.)
pacman still exits 0 and omarchy update reports success. Sometimes nvidia-smi on a TTY prints NVRM: API mismatch: this kernel module has version 595.58.03 but this NVIDIA driver component has version 595.71.05.
Cause
nvidia-open-dkms / nvidia-dkms failed to compile against the newly installed kernel. On Omarchy 4 the usual reason is that the driver does not support that kernel yet (issue 5706 was a GCC internal compiler error in NVIDIA's source on 7.0.x), because install/hardware/nvidia.sh already installs the matching <kernel>-headers package. Missing headers is still the first thing to check for a second kernel you added yourself (linux-lts without linux-lts-headers) and on plain Arch, and a kernel and module built with different GCC major versions is the other classic cause.
Omarchy's install/hardware/nvidia.sh writes MODULES+=(nvidia nvidia_modeset nvidia_uvm nvidia_drm) to /etc/mkinitcpio.conf.d/nvidia.conf for early KMS, and the package-owned /etc/mkinitcpio.conf.d/omarchy_hooks.conf drops the kms hook when nvidia_drm is early-loaded and NVIDIA owns every display controller. When those four modules do not exist mkinitcpio prints module not found for each, still writes the image, then exits non-zero. limine-mkinitcpio-install treats that exit code as a failure, prints mkinitcpio failed for kernel ..., skipping. and never installs the staged UKI. Nothing gets rebuilt and pacman exits 0, so /boot/EFI/Linux/omarchy_linux.efi still holds the OLD kernel and the OLD nvidia module in its initramfs, while nvidia-utils on disk is new. The kernel/userspace version pair no longer matches, Hyprland aborts in CHyprOpenGLImpl::initEGL, and SDDM loops. On plain Arch with a normal initramfs the outcome is different: mkinitcpio -P installs the incomplete image anyway, the new kernel boots with no nvidia module, and you get a black screen or a bare framebuffer instead.
One Omarchy detail decides whether you can recover without rebooting. Omarchy 4 installs kernel-modules-hook, whose pacman hooks copy the running kernel's whole module tree (including build/ and updates/dkms/) aside before the transaction and restore it afterwards. DKMS therefore builds the new driver for the running kernel too, and if that build succeeded you can unload the stale module and load the new one in place. Plain Arch without that package deletes /usr/lib/modules/<running kernel> during the kernel upgrade, so nothing can be modprobed until you reboot.
Fix
Get a text console with Ctrl+Alt+F2 and log in.
Find out what actually failed:
uname -r
ls /usr/lib/modules/
dkms status
pacman -Q linux linux-lts linux-headers nvidia-open-dkms nvidia-utils 2>/dev/null
sudo tail -40 /var/lib/dkms/*/*/build/make.log
**If you are stuck in the SDDM login loop** (kernel module and userspace disagree), you can unstick the running session without a reboot, but only when dkms status shows the NEW driver version installed for the kernel uname -r reports:
dkms status | grep "$(uname -r)" # must list the new driver version as installed
sudo systemctl stop sddm
sudo modprobe -r nvidia_drm nvidia_uvm nvidia_modeset nvidia
sudo modprobe nvidia_drm
sudo systemctl start sddm
Omarchy 4 ships kernel-modules-hook, which is what keeps the running kernel's modules on disk through the upgrade so this works. On plain Arch without that package the running kernel's module directory is gone after a kernel upgrade, modprobe nvidia_drm will fail with Module nvidia_drm not found, and you would be left with no driver at all: skip this block, rebuild, and reboot.
Install the headers that match every installed kernel and rebuild the modules. Omarchy 4 already installs <kernel>-headers for the kernel it found at install time, so this step matters for a second kernel you added and for plain Arch:
sudo pacman -S --needed linux-headers # add linux-lts-headers / linux-zen-headers as applicable
sudo dkms autoinstall -k 7.0.3-arch1-2 # the kernel version from ls /usr/lib/modules/
dkms status # every kernel should now show "installed"
Confirm the modules really exist before you rebuild the boot image:
ls /usr/lib/modules/7.0.3-arch1-2/updates/dkms/nvidia*.ko*
Rebuild the initramfs. On Omarchy 4 (Limine + UKI) you must use the Limine wrapper, not bare mkinitcpio: /etc/mkinitcpio.d is empty on Omarchy 4, so mkinitcpio -P stops with No presets found and the UKI on the ESP is never replaced:
sudo limine-mkinitcpio # Omarchy / limine-mkinitcpio-hook
# plain Arch with a normal initramfs instead:
sudo mkinitcpio -P
Read that output. There must be no module not found: lines and no mkinitcpio failed for kernel ..., skipping. Verify modeset is on before rebooting:
cat /sys/module/nvidia_drm/parameters/modeset # must print Y
cat /etc/modprobe.d/nvidia.conf # options nvidia_drm modeset=1
cat /etc/mkinitcpio.conf.d/nvidia.conf # MODULES+=(nvidia nvidia_modeset nvidia_uvm nvidia_drm)
If the driver genuinely does not support the new kernel yet, install an LTS kernel to boot from and rebuild:
sudo pacman -S --needed linux-lts linux-lts-headers
sudo dkms autoinstall
sudo limine-mkinitcpio
If you are already at a black screen and cannot reach a TTY, pick a pre-update snapshot from the Limine menu (Omarchy ships limine-snapper-sync and lists snapshots under Snapshots), or press e on the boot entry and add nomodeset to the cmdline: line to reach a console, then follow the steps above.
Verify
dkms status shows installed for every kernel in /usr/lib/modules. sudo limine-mkinitcpio completes with no module not found lines. After reboot cat /sys/module/nvidia_drm/parameters/modeset prints Y and modinfo -F version nvidia matches pacman -Q nvidia-utils.
Sources
- https://github.com/basecamp/omarchy/issues/5706
- https://github.com/basecamp/omarchy/blob/quattro/install/hardware/nvidia.sh
- https://github.com/basecamp/omarchy/blob/quattro/etc/mkinitcpio.conf.d/omarchy_hooks.conf
- https://wiki.archlinux.org/title/NVIDIA
- https://wiki.archlinux.org/title/Dynamic_Kernel_Module_Support
- https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio
- https://bbs.archlinux.org/viewtopic.php?id=295952
- https://wiki.archlinux.org/title/Limine
- https://github.com/limine-bootloader/limine/blob/trunk/CONFIG.md
- https://github.com/limine-bootloader/limine/blob/trunk/common/menu.c