OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
gpu-drivers high occasional DISPUTE

Finish an Omarchy install that fails with 'target not found: nvidia-580xx-dkms'

omarchyarchnvidialaptop
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

Checked on this Omarchy 4.0.2-1 workstation (omarchy 4.0.2-1, mkinitcpio 41.1-1, limine-mkinitcpio-hook 1.37.1-1, kernel 7.1.9-arch1-2) and against the upstream quattro tree and both cited issues read in full. The core claim holds: I read /usr/share/omarchy/install/hardware/nvidia.sh locally and fetched the same file from omacom/omarchy at quattro, and the omarchy-hw-nvidia-without-gsp branch does request exactly nvidia-580xx-dkms, nvidia-580xx-utils and lib32-nvidia-580xx-utils. Issue 7947 is open, quotes the same two target not found lines, and confirms the failure aborts the install. Four things were wrong for Omarchy 4. First, the path: the record sends the reader to ~/.local/share/omarchy/install/config/hardware/nvidia.sh, which is the Omarchy 3 git-checkout layout. Omarchy 4 is pacman-packaged and the file is /usr/share/omarchy/install/hardware/nvidia.sh (confirmed with pacman -Qo), reached as /mnt/usr/share/omarchy/... during the ISO install, which is the path issue 7947 itself names. Second, the AUR claim: pacman -Sl omarchy on this machine lists all three packages in the [omarchy] repository at 580.178.04-1.1 with a build date of 2026-08-13, ten days before issue 7947 was filed, and omarchy-pkg-add is plain pacman -S --noconfirm --needed that never consults an AUR helper, so yay -S is the wrong tool and "they live in the AUR" is the wrong cause. Third, sudo mkinitcpio -P fails on Omarchy 4: /etc/mkinitcpio.d/ is empty and mkinitcpio line 986 dies with No presets found in /etc/mkinitcpio.d, so the rebuild is sudo limine-mkinitcpio. Fourth, the ~/.config/hypr/envs.conf block is Omarchy 3 hyprlang and is redundant: /usr/share/omarchy/default/hypr/nvidia.lua, which I read both locally and upstream, already sets NVD_BACKEND=egl and __GLX_VENDOR_LIBRARY_NAME=nvidia behind the same omarchy-hw-nvidia-without-gsp test. The danger was rewritten because there is no git working tree to be dirty on Omarchy 4. The real risk is a silent pacman overwrite of a non-backup file, and the rebuild step needed a recovery path stated, which Omarchy 4 does not provide as a fallback initramfs entry. All three cited URLs are removed: https://github.com/basecamp/omarchy/issues/7947 and .../3954 both return HTTP 404 to curl -L, because GitHub's rename redirect covers the repository root and blob paths but not issue paths, and the basecamp/omarchy/blob/master/install/config/hardware/nvidia.sh URL resolves but serves the Omarchy 3 script and is the origin of the wrong path in the fix. Confirmed on this machine: the file paths, package ownership, the [omarchy] repository contents, the empty preset directory, the mkinitcpio die message in source, bash -eE in run_logged, Backup Files : None, and that the ALPM guard blocks only sync plus sysupgrade. Not exercised: I did not run an Omarchy install, so the claim that the [omarchy] database is what is missing during the ISO hardware stage rests on issue 7947 plus the package build date, not on a reproduction, and this workstation carries an RTX 3090 (GA102, 0x2204) so it takes the GSP branch and I could not run the 580xx path at all.

The cause above was rewritten on 2026-09-11 to match this note; the fix was corrected by the audit itself.
RISK

/usr/share/omarchy/install/hardware/nvidia.sh is owned by the omarchy package and is not a pacman backup file (pacman -Qii omarchy reports Backup Files : None), so the exit 0 edit is overwritten with no .pacnew and no warning the next time omarchy is upgraded, and pacman -Qkk omarchy flags it as altered until you revert it. Treat it as a workaround for one install, not a setting. Step 4 rebuilds the initramfs and rewrites the UKI on the ESP. If the machine then fails to reach Hyprland, Omarchy 4 builds no fallback initramfs entry, so recovery is a Limine btrfs snapshot entry (run limine-list first to see which exist) or a chroot from the Omarchy ISO. Do not reach for pacman -Sy to pick up the [omarchy] database: on its own it is a partial upgrade and a classic way to break an Arch system.

Symptom

During an Omarchy 4 install, or when re-running omarchy apply hardware, on a machine with an MX150, GTX 1050 or similar Maxwell, Pascal or Volta GPU, the hardware stage aborts with:


error: target not found: nvidia-580xx-dkms
error: target not found: lib32-nvidia-580xx-utils
[Failed]: /usr/share/omarchy/install/hardware/nvidia.sh (exit code: 1)

The whole install stops there rather than skipping the driver and carrying on.

Cause

Omarchy 4's /usr/share/omarchy/install/hardware/nvidia.sh runs omarchy-hw-nvidia-without-gsp, which matches any NVIDIA display device whose PCI ID is at least 0x1340 and below 0x1e00, the Maxwell, Pascal and Volta span. On a match it asks omarchy-pkg-add for nvidia-580xx-dkms, nvidia-580xx-utils and lib32-nvidia-580xx-utils, because nvidia-dkms dropped Pascal at driver 590. omarchy-pkg-add is plain pacman -S --noconfirm --needed, so every target has to come from a synced pacman database and no AUR helper is ever consulted. None of the three is in core, extra or multilib. On an installed Omarchy 4.0.2 system they come from the [omarchy] repository at 580.178.04-1.1. The install fails when that repository is not reachable or its database is not synced at the hardware stage, which is what the ISO's offline package set produces. pacman then reports target not found, omarchy-pkg-add exits 1, and because run_logged executes each hardware script under bash -eE the script dies immediately and takes the rest of the install with it.

Fix

Skip the failing hardware script, finish the install, then install the driver from the [omarchy] repository after first boot.

**1. Neutralise the hardware script in the install target.** From the ISO the installed system is mounted at /mnt, so the path carries that prefix:


sudo sed -i '1i exit 0' /mnt/usr/share/omarchy/install/hardware/nvidia.sh

On an already-booted machine that is failing a re-run of omarchy apply hardware, drop the /mnt:


sudo sed -i '1i exit 0' /usr/share/omarchy/install/hardware/nvidia.sh

**2. Resume the install.** This is the step the reporter of omacom/omarchy#7947 used:


sudo omarchy-apply-system

**3. After first boot, sync the databases and install the driver.** All three packages are in the [omarchy] repository (Server = https://pkgs.omarchy.org/stable/$arch), so no AUR helper is involved. Run omarchy update first, because a bare pacman -Sy is a partial upgrade:


omarchy update
sudo pacman -S --needed linux-headers nvidia-580xx-dkms nvidia-580xx-utils lib32-nvidia-580xx-utils

The ALPM guard blocks only -S combined with -u, so a plain pacman -S is allowed here. On a non-stock kernel install that kernel's headers instead, for example linux-lts-headers.

**4. Apply the configuration the script never reached.** run_logged in install/hardware/all.sh runs each script under bash -eE, so nvidia.sh died at the package step and wrote neither file:


printf 'options nvidia_drm modeset=1\n' | sudo tee /etc/modprobe.d/nvidia.conf
printf 'MODULES+=(nvidia nvidia_modeset nvidia_uvm nvidia_drm)\n' | sudo tee /etc/mkinitcpio.conf.d/nvidia.conf
sudo limine-mkinitcpio

Use limine-mkinitcpio, not mkinitcpio -P. Omarchy 4 keeps /etc/mkinitcpio.d/ empty and builds a UKI through Limine, so mkinitcpio -P stops with ERROR: No presets found in /etc/mkinitcpio.d.

**5. Do nothing about Hyprland environment variables.** Omarchy 4 sets them per session from /usr/share/omarchy/default/hypr/nvidia.lua, which runs omarchy-hw-nvidia-without-gsp and applies NVD_BACKEND=egl and __GLX_VENDOR_LIBRARY_NAME=nvidia for exactly this class of card. The env = NVD_BACKEND,egl lines in ~/.config/hypr/envs.conf are Omarchy 3 hyprlang syntax and Omarchy 4 does not read them.

**6. Put the script back**, then reboot:


sudo sed -i '1{/^exit 0$/d}' /usr/share/omarchy/install/hardware/nvidia.sh
pacman -Qkk omarchy
reboot

Until the driver is installed the machine runs on nouveau, which is slow but fine for finishing setup.

Verify


pacman -Q nvidia-580xx-dkms                                       # prints 580.178.04-1.1 or newer
dkms status                                                       # nvidia 580.178.04 installed for the running kernel
nvidia-smi                                                        # reports the GPU
sudo lsinitcpio /boot/EFI/Linux/omarchy_linux.efi | grep nvidia   # the four modules are in the UKI
pacman -Qkk omarchy                                               # 0 altered files, so step 6 really reverted the edit

/boot is a vfat ESP mounted dmask=0077, so the lsinitcpio line needs root. There is no /boot/initramfs-linux.img to inspect on Omarchy 4.

Sources

omarchy-nvidia-580xx-target-not-found