Getting Started

Before installing Omarchy, you should consider whether Omakub might not be a better fit. If you're new to Linux, and if the idea of installing an OS entirely from the command line seems a bit much, it almost certainly is.

But if you're determined, the first step is to install Arch:

  1. Download the Arch ISO, put it on a USB key for installation, and boot into the Arch installer.
  2. If you're on wifi, use iwctl to connect to your network. Start it, then run station wlan0 connect <tab> to autocomplete to the right network, and you'll be asked for the password. If you're on ethernet, this isn't necessary.
  3. Run archinstall command and follow this path:
Mirrors and repositories > Select regions > [Pick mirror closest to you]
Disk configuration > Partioning > Use a best-effort default partioning layout > [Select drive to install on using arrows + space for select, then return] > Filesystem: btrfs > Default structure: Yes > Use compression 
Disk encryption > Encryption type: LUKS > Encryption password

With Arch installed, select reboot, and you'll be ready to run the Omarchy installer after logging in with your user on the command line by running wget -qO- https://omakub.org/install | bash.

Depending on your internet connection, the entire setup can be done in less than 10 minutes.

You should be able to complete the whole process in less than 30 minutes, depending on your internet connection. (Note that Omakub is only tested on fresh installations of Ubuntu 24.04 and 25.04. If you already have an installation, use a different version, or even a different distribution, you'll be on your own.)

It's normal that some application, like Obsidian, takes a long time to install. Do not be alarmed if the installer is working quietly for several minutes at the time.

It's highly recommended that you encrypt the drive when you're installing Ubuntu. When you see this screen during the 24.04 install:

select-encryption-1.png

Select "Advanced Options", then:

select-encryption-2.png

During the 25.04 installation, encryption is now the default.

Remember that to install Ubuntu on your computer, you'll need a USB thumb drive to serve as the installation media. It needs to be at least 12GB.

If you don't already have a computer for running Omakub, the Framework 13 is a great laptop for the purpose. An awesome configuration would be the AMD 7640U with 32GB RAM and 1TB SSD. If you prefer a desktop machine, the Minisforum UM870 or Beelink SER8 are both good bargains too.

You can also find desktops and laptops optimized for Linux from System76, Tuxedo Computers, and Slimbook. The vast majority of mini PCs from makers like Beelink, Minisforum, and the like work great too. And, of course, from mainstream vendors like Dell, Lenovo, HP, and others (but then you have to make sure you get something well supported).

Now that Omakub is installed on your computer, let's learn all about it.