Independent Omarchy Guide
Getting started

Your First Day After Installing Omarchy

Learn the Omarchy desktop, top bar, launcher, clipboard, hardware checks, updates, and backups before turning a new install into a daily workstation.

The goal of your first Omarchy session is not deep customization. Confirm that the machine boots reliably, essential hardware works, your data has an independent backup, and you can reach the main controls from the keyboard. Import important data only after these checks pass.

Keep a non-Bluetooth keyboard available

A default encrypted installation normally cannot use a Bluetooth keyboard at the pre-boot unlock screen. Use a wired keyboard or a 2.4 GHz receiver until the disk is unlocked.

Entering the desktop

The first-run flow collects the keyboard layout, user name, and password. Once the desktop appears, learn four entry points:

TaskCommon entry point
Open the Omarchy menuSuper + Space
Open a terminalSuper + Return
Open a browserSuper + Shift + Return
Close the focused windowSuper + W, or the binding shown by current hotkey help

Super is normally the Windows key. On a Mac keyboard it is usually the physical key marked Command, subject to your active keyboard mapping.

Read the top bar

The top bar is part of the Quickshell-based Omarchy Shell. The left side contains the menu and workspaces, the center usually carries time, status, and update indicators, and the right side contains the tray, AI agents, Bluetooth, network, audio, display, and power. Some icons appear only after their feature becomes relevant.

Common keyboard-accessible panels include:

  • Super + Ctrl + A: audio;
  • Super + Ctrl + W: network;
  • Super + Ctrl + B: Bluetooth;
  • Super + Ctrl + D: display;
  • Super + Ctrl + P: power.

Use arrows to move, Return to act, Tab to move between panels, and Escape to close. Check the current Top Bar manual if a release changes a binding.

Unified clipboard and files

Omarchy uses Super + C for copy, Super + X for cut, Super + V for paste, and Super + Ctrl + V for text and image history across most terminal and graphical applications. Selecting a history entry puts it back on the clipboard for the next paste.

Clipboard history may contain tokens, passwords, and screenshots. Clear sensitive material before sharing or recording the screen, and never treat clipboard history as durable storage.

Post-install checklist

  1. Complete a normal shutdown, boot, and disk unlock.
  2. Test Ethernet or Wi-Fi, DNS, audio input/output, and Bluetooth.
  3. Verify scaling, refresh rate, external displays, sleep, and wake.
  4. Set timezone, keyboard layouts, and any required input method.
  5. Run one planned update through Omarchy, reboot, and check your workflow.
  6. Establish an independent user-data backup; snapshots are not enough.
  7. Restore or clone one test project and verify browser, editor, Git, and keys.
  8. Bookmark the troubleshooting guide and official manual.

Avoid these first-day mistakes

  • Do not replace all of ~/.config at once.
  • Do not run a system update, an AUR updater, and third-party installers together.
  • Do not remove the old operating system before proving recovery.
  • Do not replace every binding and theme just to match a screenshot.
  • Do not confuse a same-disk system snapshot with an off-device backup.

Where to go next

Continue with input methods and fonts if you type Chinese or other complex scripts. Developers should read apps and development environments. Windows and macOS users can build habits with the 30-day migration plan.

Sources: Omarchy Getting Started, The Top Bar, and Unified Clipboard.

On this page