I ran an Omarchy update on my M1 MacBook, restarted, and got a black screen with a single blinking underscore in the top-left corner. No login screen, no error, nothing.
I spent a while assuming the bootloader was broken. It wasn't. Linux had booted fine. The update had stalled halfway on a package it couldn't find, and the login screen never came up.
The short version
- At the black screen, press Control + Option + F2 (add fn if needed) and log in at the text prompt.
- Start the desktop by hand:
uwsm start hyprland.desktop - Install the packages the update couldn't find, using the
omarchy/prefix. - Run
omarchy-migrateuntil it finishes clean. - Reboot. The login screen is back.
How to tell this is your problem
There are several different ways an Omarchy update can break boot on a Mac, and they need different fixes. This one looks like this:
| What you see | What it means |
|---|---|
| Black screen, blinking underscore top-left, and Control + Option + F2 gives a login prompt | This article. Linux is running. Only the login screen is missing. |
A [rootfs ~]# emergency shell, or "/sbin/init does not exist" | A different bug: the update rewrote the GRUB kernel options. See the links at the bottom. |
| Nothing at all after picking the Linux volume, no cursor | Likely the bootloader (m1n1 / U-Boot). Not covered here. |
The fix, step by step
- Get a text login. At the black screen, wait a minute, then press Control + Option + F2. On a MacBook keyboard you may need to hold fn as well. Log in with your normal username and password.
-
Confirm the diagnosis.
On my machine nothing had failed andsystemctl --failed systemctl status sddm --no-pager | head -20 tail -30 /var/log/pacman.logsddmshowed as running, but the pacman log ended with an install attempt that never completed:
No "installed" line after it. That's the stalled update.[PACMAN] Running 'pacman -S --noconfirm --needed -- monologue' -
Start the desktop without the login screen.
The desktop came up and Omarchy immediately tried to resume the update, then failed in plain sight:uwsm start hyprland.desktop
Close that window and open a terminal with Super + Return.Running migration (1790539857) Install Monologue, the webcam recorder error: target not found: monologue Failed (exit code 1)! -
Install the missing packages from the Omarchy repo by name.
The packages exist. pacman just can't find them by their bare name on ARM installs, so point at the repo explicitly:
If pacman stops with "target not found" for one of those, drop that name and run it again.sudo pacman -Sy sudo pacman -S --needed omarchy/monologue omarchy/hype omarchy/disktree-bin \ omarchy/omarchy-hyprland-titlebars omarchy/signed omarchy/gliff omarchy/omasnap -
Finish the update.
If it stops on another missing package, install it the same way (omarchy-migratesudo pacman -S --needed omarchy/<name>) and runomarchy-migrateagain. Mine ran through nine migrations and finished. -
Reboot.
The normal login screen came back and the desktop, top bar and menus all worked.sudo reboot
Honest caveat: I never pinned down exactly why the login screen wouldn't draw while the update was half-finished. It came back as soon as the migrations completed, and that's the part I can vouch for.
What didn't fix it
So you can skip the detours I took:
- Swapping the bootloader file. From macOS I mounted the Linux EFI partition and replaced
m1n1/boot.binwithboot.bin.old. It made no difference, because the bootloader was never the problem. - Editing GRUB kernel options. That fix is for the emergency-shell symptom, which is a separate bug.
The clue I should have read sooner: a blinking cursor means the kernel is up. If you get a cursor, try for a text login before touching anything at the boot level.
If it happens again
The underlying bug was still open when I wrote this. If a future update stops with target not found: <name>, the same two commands apply:
sudo pacman -S --needed omarchy/<name>
omarchy-migrate
My setup
| Machine | M1 MacBook, Omarchy installed alongside macOS via Asahi |
|---|---|
| Kernel | 7.1.13 (Arch Linux ARM) |
| omarchy | 4.5.0rc1-1 |
| quickshell | 0.3.1-1 |
| qt6-base | 6.11.2-3 |
| sddm | 0.21.0-7 |
Related bug reports
- omarchy #16936: ARM (Asahi) installs can't update, migrations fail with "target not found"
- omarchy-mac #758: omarchy-migrate can't find packages that exist in the Omarchy repo
- omarchy #12874: the separate GRUB bug that drops you to an emergency shell