Unofficial community reference. Not affiliated with 37signals or the Omacom Foundation. Download Omarchy only from omarchy.org.
omarchylinux.org Unofficial field manual

Releases

Release notes live only on GitHub and omarchy.org has no changelog page. This is the browsable version: each release with its notes, the migrations it ran, and the commands it added or removed. Current: v4.0.4.

4.0.4-1stable channel · omarchy package
4.0.4-1rc channel · omarchy package
4.0.4-1edge channel · omarchy package
714 hstable-mirror behind Arch upstream
714 hrc-mirror behind Arch upstream
0 hmirror behind Arch upstream

Channel data fetched 2026-10-07T11:17. See channel and mirror status and closed issues people still reproduce.

ReleaseDateNotesMigrations
v4.0.4 2026-09-15This release brings our bespoke kernel to everyone. The Omarchy kernel is tuned to keep the desktop responsive and multitasking smooth, even under heavy load or memory pressure. It improves gaming compatibility, enables smoother gaming on supported AMD HDMI displays, speeds up common Btrfs file oper2
v4.0.3 2026-09-08This release brings amazing out-of-the-box integration for both Hermes and Openclaw as well as additional set of security fixes that were validated and examined by the [Omarchy Security team](https://omarchy.org/teams/#security). If you ever find security issues with Omarchy, please follow the respo9
v4.0.2 2026-08-31This is an additional set of security fixes that were validated and examined by the [Omarchy Security team](https://omarchy.org/teams/#security). If you ever find security issues with Omarchy, please follow the responsible disclosure procedure on [omarchy.org/security](https://omarchy.org/security/)10
v4.0.1 2026-08-25This is mostly for a collection of security fixes that was validated and examined by the [new Omarchy Security team](https://omarchy.org/teams/#security). If you ever find security issues with Omarchy, please follow the responsible disclosure procedure on [omarchy.org/security](https://omarchy.org/s8
v4.0.0 2026-08-14Omarchy 4 aka Quattro is the biggest release since the project started. The entire desktop shell has been reimagined in [Quickshell](https://quickshell.org): the bar, launcher, menus, notifications, on-screen displays, control panels, lock screen, and polkit agent now all live inside a single long-r78
v3.8.4 2026-07-21Update existing installations using Update > Omarchy from Omarchy menu (Super + Alt + Space). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.8.4.iso SHA256: 7bc1dc7d98f3d088e57dc06581a494ea441fb15f3edd191360fd1696931bd895 Fix Neovim theme symlink pointing at the Om330
v3.8.3 2026-07-13Update existing installations using Update > Omarchy from Omarchy menu (Super + Alt + Space). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.8.3.iso SHA256: 40c9368eeb7e021a13d0899b379517843b4839f6e7721473169369fbd0fe61ac Add easier tmux pane controls with `Alt+Ent
v3.8.2 2026-05-24Update existing installations using Update > Omarchy from Omarchy menu (Super + Alt + Space). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.8.2.iso SHA256: dc3d096ed17f50cadc74d5f2fe1914b12e1ba6b69e84447225deaf1896a0820d Fix logs uploading by switching to Omarchy-
v3.8.1 2026-05-14Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Hotfix to pin `omarchy-reinstall-git` to `master` branch to prevent accidental switch to `dev` by @ryanrhughes
v3.8.0 2026-05-09Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.8.0.iso SHA256: a9b271e8884dc123f0787e10cff3153dca7361cc6583edd1a3baa283a031f872 Add setting reminders via `Super + Ctrl
v3.7.1 2026-05-04Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Hotfix to remove lingering `xe.enable_panel_replay=0` setting from `KERNEL_CMDLINE` by @ryanrhughes
v3.7.0 2026-05-04Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.7.0-2.iso SHA256: f74c1ed2ab6d2164c530e97a10e8dc5debe72bd9aec32989c7354ecb406bea99 Add unified `omarchy` CLI by @ryanrhu
v3.6.0 2026-04-23Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.6.0-2.iso SHA256: b43914a3c842920c6b8bec6a8fc1878291a359551945f17595b7a4ca3ef7ab44 Add additional kernel patches to cust
v3.5.1 2026-04-16Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.5.1-2.iso SHA256: f28ce9f6d0d70d2a79ae584e52de7ce3cb5c21c6c1ffb806073db1df2140b03a Add Dell XPS mute mic key support wit
v3.5.0 2026-04-03Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.5.0-2.iso SHA256: 0d3a7944240df631c5c9f7802d735a96bb0a6a3f8a65b7d45b609699aa888bd5 Add full compatibility with Intel Pan
v3.4.2 2026-03-08Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.4.2-2.iso SHA256: cf5ff60b7a9de4b4b82512bc6068e450bf0e9ff77c7082ae6624d022ec6faa33 Add fuller battery status notificatio
v3.4.1 2026-02-28Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.4.1-2.iso SHA256: bad8ccd14a715ec5d67ab61c9e8258c1cee44176cf35050e72e047506f1c1120 Add `Super + L` to toggle between the
v3.4.0 2026-02-26Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.4.0.iso SHA256: a68349ddf41b2553b4dfbae6bd6f08a993a12dc5ccec1d9316a4c0ac2bb33649 *IMPORTANT:* If upgrading from a versio
v3.3.3 2026-01-08Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Hotfix to ignore updating `gcc14` via `omarchy-update` by @ryanrhughes **Full Changelog**: https://github.com/basecamp/omarchy/compare/v3.3.2...v3.3.3
v3.3.2 2026-01-08Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.3.2.iso SHA256: 64dcb48029cca7668170e7d2a9b6b95058d522d6fe8b3588f14a35e687ba903d Fix Nvidia driver installation issue ca
v3.3.1 2026-01-08Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.3.1.iso SHA256: 25657c6658d2ef8dadcaa24677952e745ce4ccf34b80b6cf71af8dfae5a1c294 Fix nvidia detection of older professio
v3.3.0 2026-01-07Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.3.0.iso SHA256: d6de3c8ba3c856acdded8c4ec8b352487d504aabb20687c89d325e1236611977 *IMPORTANT:* While updating to 3.3.0, y
v3.2.3 2025-12-15Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.2.3-2.iso SHA256: 7a40fac851642b243ab0f1098759063c4ecbd37dd99bdb7da8ba1868a7153d85 Add Alacritty back as a default packa
v3.2.2 2025-11-29Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.2.2.iso SHA256: a9d26b1d053cab92326031a2b4c19b337afb8a0ea7192077fa21cf629728d9cc Add `Super + Shift + Alt + ,` to restor
v3.2.1 2025-11-26Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.2.1.iso SHA256: a9d26b1d053cab92326031a2b4c19b337afb8a0ea7192077fa21cf629728d9cc Add release channel and last update dat
v3.2.0 2025-11-21Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.2.0.iso SHA256: 6b6c085c20a0afee21401f15bfb04a4a5a8bd1d989186bf68f735a3781895390 Add new stable Arch mirror + stable pkg
v3.1.7 2025-11-09Update existing installations using Update > Omarchy from Omarchy menu (Super + Alt + Space) or download ISO for new installs:. Download: https://iso.omarchy.org/omarchy-3.1.7.iso SHA256: e264648d0b96c49a664fea82c92d9aa16737913cdec29eb5c8e4154e9665bbae Fix hyprland config in pip.conf to address newl
v3.1.6 2025-11-07Update existing installations using Update > Omarchy from Omarchy menu (Super + Alt + Space). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.1.6.iso SHA256: 39858b4f20f1db75a9dc81a4975a300ad72dddca6e8bdb70cc486ae6c3e621c2 Add a hotfix to fix limine order sourcing c
v3.1.5 2025-11-03Update existing installations using Update > Omarchy from Omarchy menu (Super + Alt + Space). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.1.5.iso SHA256: 92c417f153a1af112973f5af52104d9dd0442d270b0f241bf91a232dd2b5b8df Add `Super + O` to pop a window out into a
v3.1.4 2025-10-28Update existing installations using Update > Omarchy from Omarchy menu (Super + Alt + Space). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.1.4.iso SHA256: d845db165a2878e9543251e56e68750b4ce61b61b0e260e2797939ea2ac07caf Add better presentation of keybindings in o
v3.1.3 2025-10-24Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.1.3.iso SHA256: fcb050d2adceded03e90939937be01583f6d95829273fd5e037b1fdf7cc81ab8 Hotfix: Prevent showing an error state
v3.1.2 2025-10-24Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.1.2.iso SHA256: f428fa1bc6656b8a576ab6c05d52be91f3d71bebac1bb2713f70dc7b035eab40 Add dynamic resolution, sound, micropho
v3.1.1 2025-10-20Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.1.1.iso SHA256: 4d2cdf7b0cfe763e32c98447ebe8add891f47ab9d054732369b92fcc6dd1baa8 Add binding for tiled full screen toggl
v3.1.0 2025-10-19Update existing installations using `Update > Omarchy` from Omarchy menu (`Super + Alt + Space`). Install on new machines with the ISO: Download: https://iso.omarchy.org/omarchy-3.1.0.iso SHA256: 85b9790e7687ca9e8137c9d2b8c52643686c229cad1e1aae353c76ee8f6aba00 Add universal copy/paste on `Super + C
v3.0.2 2025-09-28Existing installations can upgrade as per-normal using `Update > Omarchy`. New installations should download the fresh, all-inclusive ISO: https://iso.omarchy.org/omarchy-3.0.2.iso. **ISO SHA256**: `8d136a99d74ef534b57356268e5dad392a124c7e28487fc00330af9105fc6626` Fix osaka jade theme for Ghostty by
v3.0.0 2025-09-17Omarchy 3.0 is a major upgrade for new installations and a wonderful level-up for existing users. The new ISO doesn't require internet at all, and you can install it in _less than two minutes_ on the fastest systems. You can now also install Omarchy on most pre-M MacBooks with support for keyboards,
v2.1.2 2025-09-10Fix unstyled decryption screen on new installations made in the last day by @ryanrhughes Fix 6Ghz Wi-Fi compatibility on existing installations with a migration by @dhh Fix Intel graphics acceleration on existing installations with a migration by @dhh **Full Changelog**: https://github.com/basecamp/
v2.1.1 2025-09-09Add screenrecordings with audio on `ALT + SHIFT + PRINT` for region and `CTRL + ALT + SHIFT + PRINT` for full screen and to _Capture > Screenrecording_ by @dhh Add support for 6GHz Wi-Fi via wireless-regdb by @eclecticc Add visual feedback when switching between audio outputs on `Super + Mute` by @c
v2.1.0 2025-08-31Add Cloudflare-hosted Omarchy Mirror as the default place to get Arch core/extra/multilib packages by @dhh Remove chaotic-aur as a default setup now that we have our own package repo by @dhh Add omarchy-pkg-add/drop/present/missing helper commands for migrations in particular by @dhh Add omarchy-cmd
v2.0.5 2025-08-28Fix package repository order so Arch defaults come before Omarchy Package Repository by @dhh Fix Omarchy branch name should be exposed in the About screen by @dhh Fix node.js is needed for a full Laravel installation by @roberto-aguilar Fix new installs should use woff2-font-awesome instead of ttf-f
v2.0.4 2025-08-28Fix pinning package no longer needed after we shrinked the Omarchy repo by @dhh Fix iwd service shouldn't start during installation by @dhh Fix keyboard layout at install by @bastnic in https://github.com/basecamp/omarchy/pull/1188 Fix clicking on the battery icon should open the power menu by @cstr
v2.0.3 2025-08-27Fix top bar would disappear when running upgrade from the update-available icon by @dhh Fix phantom update-available icon in top bar showing up due to git network errors by @dhh Fix migration to add --working-directory to bindings.conf if its already there by @dhh Fix non-kosher use of pacman -Sy th
v2.0.2 2025-08-27Fix black-screen-of-death installs following [abseil-cpp package release](https://archlinux.org/packages/extra/x86_64/abseil-cpp/) at 2025-08-26 22:15 UTC that broke installs by @dhh Fix About info display by @tahayvr Fix font size for About when system font size has changed by @dhh Update as per us
v2.0.1 2025-08-26Fix AMI bios bricking bug by @ryanrhughes Fix omarchy-launch-browser and omarchy-launch-webapp for folks using Nix home manager by @manofcolombia Fix _Update > Omarchy_ should use our new icon instead of Arch by @tahayvr Fix _Remove > Web App_ and _Remove > TUI_ for removing multi-word entries by @j
v2.0.0 2025-08-25Add new Omarchy ISO online installer using the [Omarchy Configurator](https://github.com/omacom-io/omarchy-configurator/) front-end to archinstall by @torxed + @dhh + @ryanrhughes + @jardahrazdera + @tahayvr Add new Omarchy Package Repository (OPR) as replacement for AUR hosted on Cloudflare for all
v1.13.0 2025-08-11Add Install > Gaming to ease installation of Steam, RetroArch, and Minecraft by @dhh Add Install > Development to ease installation of many major development environments by @dhh, @fhammerschmidt, @florianbeer, @c4software, @abdellahrk, @devmobasa, @Macho0x Add Install > Editor options for Sublime T
v1.12.1 2025-08-08Add Install > AI with suggestions for claude, gemini, LM studio, crush, and opencode by @dhh Add Install > Style to group Theme/Font/Background like we do in Setup > Style by @dhh Add Update > Process to make the omarchy-restart-* scripts available via the Omarchy menu by @dhh Add highlight of curre
v1.12.0 2025-08-07Add Osaka Jade theme to default collection by @Justikun Add Style > Font as a walker interface in Omarchy menu rather than shelling out by @dhh Add Style > Font changes will now be reflected in Waybar, SwayOSD, fontconfig as well by @dhh Add Install > Editor section in Omarchy menu with common optio
v1.11.0 2025-08-05Add new unified Omarchy menu system by @dhh Add touchpad gestures to Chrome by @ryanrhughes Fix picture-in-picture window positioning by @ElFitaFlores + @dhh Fix hypridle screensaver starting after actually 2.5 minutes by @rmacklin Fix hyprpicker should toggle not stack by @dhh Fix error handling in
v1.10.0 2025-08-03Add toggling nightlight display temperature via [hyprsunset](https://wiki.hypr.land/Hypr-Ecosystem/hyprsunset/) on `SUPER + CTRL + N` by @JaxonWright Add auto-discovery of network printers by @rockorager + @dhh Add human descriptions to dynamically discovered keybindings cheat sheet (`SUPER + K`) by
v1.9.0 2025-08-02Add starting screensaver after 1 minute by default and include it in the power menu by @dhh Add invitation to update Omarchy when a new version is available via waybar icon by @dhh Add invitation to reboot the system when the Linux kernel has been upgraded after `omarchy-update` by @dhh Add faded nu
v1.8.0 2025-07-30Add font menu for easily changing terminal fonts via `omarchy-font-menu` and in Omarchy TUI by @dhh Add more resilient migration strategy that tracks which migrations you've run by @ardavis Add `Themes > Update` to Omarchy TUI to refresh extra themes by @ryanrhughes Add .bak.$timestamp strategy to t
v1.7.0 2025-07-28Add new Omarchy screensaver on SUPER + ALT + SPACE by @dhh Add a beautiful brown ristretto theme by @gthelding Add ALT+TAB to cycle between windows, including floating ones, on the active workspace by @c4software Add Omarchy version to About app by @tahayvr Fix About should float and center Fix upda
v1.6.2 2025-07-26Add updating timezone (using geo by IP) by right-clicking on the clock by @dhh Add color terminal text effects for the installer and break it into 5 distinct segments by @dhh Add a cleaned-up version of the Omarchy logo by @tahayvr and @seanmitchell Add Chaotic-AUR support for precompiled installati
v1.6.1 2025-07-23Add themed on-screen displays for brightness and volume by @aifrim Add player controls to on-screen display by @precision Add Sunset Lake as the first background for Tokyo Night by @dhh Add MariaDB as option for Docker DB setups by @spdawnson Add an increased pamlock limit from 3->10 to prevent sudo
v1.6.0 2025-07-22Add screenshot image manipulation with [satty](https://github.com/gabm/Satty) by @dhh Add screenrecording on `ALT + PrintScreen` for region, `ALT + CTRL + PrintScreen` for whole display by @dhh Add Walker for app launcher and menus instead of wofi by @ryanrhughes Add Cappuccin Latte as the second li
v1.5.2 2025-07-19Add link to community Discord if installation fails by @dhh Fix missing directories now required for startup that was preventing new installs by @alansikora in https://github.com/basecamp/omarchy/pull/233 @alansikora made their first contribution in https://github.com/basecamp/omarchy/pull/233 **Ful
v1.5.1 2025-07-18Fix long black screen waits after loader due to Docker network timeouts by @ryanrhughes in #223 **Full Changelog**: https://github.com/basecamp/omarchy/compare/v1.5.0...v1.5.1
v1.5.0 2025-07-18Add support for light themes with the `theme/light.mode` file flag by @dhh Add Rose Pine as the first included light mode theme by @dhh Add Fido2 setup with sudo authentication by @icehunt Add default firewall config w/ Docker protection using ufw by @dhh in #201 Add git stash/pop before `omarchy-up
v1.4.1 2025-07-16Add fully user-editable wofi styles in .config/wofi by @dhh Fix matte black theme wasn't getting picked up for some users by @dhh Fix all wofi menus should toggle on their binding instead of stack by @dhh Fix opening manual from Omarchy TUI on command line by @dhh Fix repeated configs in waybar conf
v1.4.0 2025-07-16Add menu-based theme switcher by @npenza in #154 Add collapsing tray for dropbox/keyboard/zoom icons in top bar by @leonhazen in #130 Add new matte black theme by @tahayvr Add Omarchy TUI for easier theme/setup/update/manual access by @npenza and @dhh in #116 Add theme installer for git-based third-
v1.3.2 2025-07-11Fix show keybindings for the new subdivided files by @dhh Fix nautilus image previews (`Space` when in the file manager) should float and center the preview by @dhh **Full Changelog**: https://github.com/basecamp/omarchy/compare/v1.3.1...v1.3.2
v1.3.1 2025-07-11Add 10% battery warning by @Mane-Pal in #121 Add bare mode via `wget -qO- https://omarchy.org/install-bare | bash` that only installs essential apps by @dhh Add all application bindings to default `~/.config/hypr/hyprland.conf` to make it easier to do app substitutions by @dhh Fix that .inputrc rule
v1.3.0 2025-07-10Add a beautiful Omarchy decryption + loading flow by @ryanrhughes in #89 Add theme-consistent coloring of the new power menu by @dhh Add fingerprint authentication to sudo + system prompt when using `omarchy-fingerprint-setup` by @dhh in #109 Add idle/sleep prevention on `Super + Ctrl + I` by @dhh A
v1.2.0 2025-07-07Add power menu to waybar by @npenza in #65 Add bash completion by @smola in #80 Add hotkeys for notifications: `Super+,` to dismiss latest. `Super+Shift+,` to dismiss all. `Super+Ctrl+,` to toggle DND by @ThiaudioTT , @ryanrhughes, and @dhh Add thumbnails for videos in the file manager by @dhh Add a
v1.1.1 2025-07-05Add Nvidia support by @Kn0ax in https://github.com/basecamp/omarchy/pull/13 Add fingerprint authentication on the lock screen and provide `omarchy-fingerprint-setup` to configure it by @dhh + @henrysipp Add `Super + K` to show keybindings in https://github.com/basecamp/omarchy/pull/44 by @oca159 Add

Upgrade guides