The Manual

The nixarchy manual

nixarchy is Omarchy vendored for NixOS. It runs Omarchy’s real tree — the same commands, menus, themes, keybindings and shell — and replaces only what assumed Arch.

So this manual only covers what is different. Of Omarchy’s 51 manual pages, 38 are word-for-word true here and are linked straight through to omarchy.org/manual. The 13 that are not are rewritten below, plus the ones Omarchy has no reason to have — marked nixarchy only in the table.

That is the same decision the port itself makes. Forking a manual you do not change means maintaining a copy that goes stale at every upstream release, and Omarchy releases often. Tracking upstream is a source bump, not a re-port — for the documentation as much as the code.

Start here if you are new to NixOS

   
Getting Started Two ways in: the ISO for a blank machine, the flake for NixOS you already run
The NixOS philosophy, and what it changes Why the Install menu queues instead of installing, where the line between ~/.config and your flake falls, and why nothing installed imperatively survives
Updating NixOS omarchy update, what it does underneath, generations, rollback, and why a rebuild does not change the session you are sitting in

Every topic

topic  
Welcome to omarchy same as Omarchy — read there
Getting started differs on NixOS — read here
The ISO in depth nixarchy only — read here
Coming from mac or windows same as Omarchy — read there
Navigation same as Omarchy — read there
The top bar same as Omarchy — read there
Themes same as Omarchy — read there
Hotkeys same as Omarchy — read there
Unified clipboard history same as Omarchy — read there
Reminders same as Omarchy — read there
Notices same as Omarchy — read there
Text extraction dictation same as Omarchy — read there
Screenshots recording same as Omarchy — read there
Toggles idle screensaver same as Omarchy — read there
Omarchy cli same as Omarchy — read there
Terminal same as Omarchy — read there
Neovim same as Omarchy — read there
Ai differs on NixOS — read here
Development tools differs on NixOS — read here
Per-project environments nixarchy only — read here
Python nixarchy only — read here
Prebuilt binaries nixarchy only — read here
Boxes nixarchy only — read here
Sandboxes nixarchy only — read here
Shell tools same as Omarchy — read there
Shell functions same as Omarchy — read there
Tuis same as Omarchy — read there
Guis same as Omarchy — read there
Browsers same as Omarchy — read there
Commercial apps services same as Omarchy — read there
Web apps same as Omarchy — read there
Gaming differs on NixOS — read here
Android nixarchy only — read here
Filling out pdfs same as Omarchy — read there
Windows vm same as Omarchy — read there
Other packages differs on NixOS — read here
Configuring nixarchy nixarchy only — read here
Preview changes nixarchy only — read here
Try it first nixarchy only — read here
Updates differs on NixOS — read here
Stable or unstable nixarchy only — read here
Dotfiles differs on NixOS — read here
Shell plugins same as Omarchy — read there
Monitors same as Omarchy — read there
Keyboard mouse trackpad same as Omarchy — read there
Networking same as Omarchy — read there
System sleep same as Omarchy — read there
Hardware authentication same as Omarchy — read there
Fonts same as Omarchy — read there
Backgrounds same as Omarchy — read there
Prompt same as Omarchy — read there
Branding same as Omarchy — read there
Common tweaks same as Omarchy — read there
Making your own theme differs on NixOS — read here
Mac support same as Omarchy — read there
Troubleshooting differs on NixOS — read here
How this is tested nixarchy only — read here
Faq same as Omarchy — read there
System snapshots differs on NixOS — read here
Security differs on NixOS — read here
Secrets nixarchy only — read here
Remote desktop nixarchy only — read here
Omarchy on same as Omarchy — read there
Dual boot install differs on NixOS — read here
Many machines, one repo nixarchy only — read here
A reinstall image of this machine nixarchy only — read here
Unattended installs differs on NixOS — read here

The short version of the difference

Omarchy on Arch nixarchy on NixOS
pacman -S foo a line in a file you own, then a rebuild
Install menu installs Install menu queues; nothing is built until you apply
omarchy update runs a pacman upgrade nix flake update then nixos-rebuild switch
Files in /usr/share/omarchy/ files in $OMARCHY_PATH, a read-only /nix/store path
snapper snapshots NixOS generations, in the boot menu
AUR no equivalent; omarchy pkg aur add explains instead of installing
ufw allow networking.firewall.allowedTCPPorts