Are we ARM yet?
Docs menu

Install Omarchy on an ARM PC

Omarchy builds one install image for every ARM PC it supports. This page takes a Snapdragon laptop from Windows to the Omarchy desktop.

Snapdragon laptops are supported from Omarchy 4.6. Until 4.6 is released, that means the Edge image, which is built every night. The 4.5 release image is too old for them.

NVIDIA's ARM desktops and laptops install from the same image. Apple Silicon Macs have an installer of their own. Chromebooks and Googlebooks start differently and don't install from this image.

Before you start#

  1. Find your model on the board. Its Bootable column says whether the image starts it, and its own page says what works once it runs, part by part.
    • Boots or Should boot there means the edge image picks the model's device tree by itself. Today that holds for 106 of the 118 Snapdragon models here.
    • Anything else means the image can't start it by itself yet. Help with your laptop says what gets it there.
  2. Save what you want to keep. Omarchy's installer erases the disk you choose, unless you pick free space next to Windows. Make Windows recovery media while Windows is still there, if you may want it back.
  3. Keep Windows for the first install. Graphics, sound and the battery gauge need firmware files that the laptop's maker signs. Omarchy has a package with them for some models (the model's page shows it under Firmware). For the others they come from the laptop's own Windows, so don't wipe it before Omarchy has them.
  4. Have a USB stick of 16 GB or more. The image is over 8 GB. Everything on the stick is erased.

Make the stick#

From the laptop's own Windows

The easiest way. The Omarchy Arm Installer recognises the laptop, downloads the image, copies the firmware Linux needs out of Windows' own drivers onto the stick, and writes it. BitLocker can stay on.

  1. Download OmarchyArmInstaller.exe from its latest release, right-click it and choose Run as administrator.
  2. Follow its steps. It names the laptop, lists the firmware it will copy, downloads the image and asks for the stick.
  3. To keep Windows next to Omarchy on the same disk, shrink C: in Disk Management when it asks. Omarchy needs at least 20 GB of free space there.
  4. Its last screen says how to turn off Secure Boot on your laptop and start from the stick.

From any computer

  1. Download the edge image and check that it arrived whole:
    latest=$(curl -fsSL https://nightly.omarchy.org/edge-aarch64/latest.json)
    url=$(jq -r .url <<<"$latest")
    curl -fLO "$url"
    echo "$(jq -r .sha256 <<<"$latest")  ${url##*/}" | sha256sum -c
    latest.json names the newest image and its checksum, for downloading it by hand.
  2. Write it to the stick with balenaEtcher on Windows or a Mac, or caligula on Linux.
  3. If the laptop has Windows, turn BitLocker off in Windows and let the drive finish decrypting. A stick made this way carries no firmware, so Omarchy's installer copies it from the Windows partition, which it can't read while it is encrypted.

Install#

  1. Turn off Secure Boot in the laptop's firmware settings. With it on, the laptop refuses the stick.
  2. Start from the stick, through the firmware's boot menu. The screen can stay black for a few minutes before the Omarchy logo shows.
  3. For a first look, stop here. Check the screen, the keyboard, the touchpad and Wi-Fi in the installer without installing anything.
  4. Answer the installer's questions and choose where Omarchy goes. The whole disk, another drive, or free space next to Windows. Omarchy's manual covers the install step by step and installing next to Windows.
  5. Decide on disk encryption. With it, you type a disk password at every start, before the desktop. Omarchy's manual says how to install without it.
  6. After the first start, update and restart.
    omarchy update
    Fixes for a model reach an installed computer this way. A computer installed from the edge image stays on the edge channel and gets them as they land.
  7. See what works, and put it on your model's page.
    omarchy-mise-install github:birkskyum/arewearmyet hw-test
    hw-test
    It tests the hardware with you in about a quarter of an hour. More about the test.

If something goes wrong#

The laptop goes back to Windows, or the screen flashes and stays black#

  • Check that Secure Boot is off.
  • Wait a few minutes. A black screen before the logo is normal on some models.
  • Make sure the stick holds a recent edge image, not the 4.5 release. An image without the model's device tree starts the kernel, which stops before it can draw anything, and the laptop resets into Windows.
  • Still nothing? Tell us through Add your model, with the image's version and what the screen showed last.

The disk password screen is black#

The password prompt should show as on any other computer. On a model Omarchy doesn't have the fix for yet, the screen stays dark there instead. The laptop hasn't hung. The prompt is there and waiting, but the screen isn't lit yet.

To get in now

  1. Wait a moment after the boot menu.
  2. Type your disk password and press Enter. You won't see anything while you type.
  3. Give it a minute. The screen lights up once the disk is open, and the desktop shows.
  4. Still dark? Hold the power button until the laptop is off and try again, slowly. If it keeps failing, the built-in keyboard may not work at that point either. Try a USB keyboard plugged straight into the laptop, not through a dock.

To fix it for good

  1. Update and restart. Omarchy fixes this model by model, and the update applies the fix to a computer that is already installed.
    omarchy update

    Your model's page on the board says, under Disk password prompt, whether the prompt shows on it.

  2. Still black after the update? Then nobody has made the fix for your model yet, and you can. Your AI agent can do it with you:
    hw-test fix disk-unlock
    It gets what is known about the fault, how to change the laptop safely, and how to send the fix to Omarchy so every owner of the model gets it.
  3. Or tell us. Open an issue on omacom/omarchy that names the model, with the output of these two, run from the desktop:
    cat /sys/class/dmi/id/product_name
    journalctl -k -b --no-hostname | grep -iE 'drm|panel|backlight' | grep -v 'command line'

Why it happens

The password prompt is drawn from a small boot image, before the disk is open and most drivers are loaded. On these laptops the display driver waits for the drivers of the USB-C ports (which can carry a screen) and of the backlight before it draws. When those aren't in the boot image, the driver waits until the disk is open, which is after the prompt. Omarchy's fix for a model names those drivers in a file under /etc/mkinitcpio.conf.d, so they are in the boot image. The HP OmniBook X 14's fix is a short example, and the folder beside it has every model's.

Something else doesn't work#

Look at your model's page first. It lists what is known per part, and other owners' notes with their workarounds. Then run hw-test, which measures the part, and hw-test fix, which hands what fails to your AI agent.

Find your model · Help a model get there