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

Omarchy v4.0.1

Released 2026-08-25. Official notes on GitHub 路 ISO SHA-256 69cbb4e10d98ad831c3c9f245b5757a9d1fedfd0c9592780e977d6f950dea8c3 (how to verify).

Release notes

Fast-Follow Fixes

This is mostly for a collection of security fixes that was validated and examined by the new Omarchy Security team. If you ever find security issues with Omarchy, please follow the responsible disclosure procedure on omarchy.org/security 馃檹

You can upgrade existing machines with Update > Omarchy.

Install on new machines with the ISO:

Security

  • Launch claude and codex agents with auto-review instead of full bypass by @dhh in #7001
  • Stop a video title from becoming the Download Video play command by @acrogenesis in #7847
  • Stop an installed theme from running code by @omarchybot in #7884
  • Stop the FIDO2 setup staging its authfile at a predictable /tmp path by @mdisec in #7904
  • Run notification click actions as safe argv by @ryanrhughes in #7926
  • Remove the sudo lockout reset command by @omarchybot in #8046
  • Don't put the user in the docker group; make it opt-in by @omarchybot in #8056
  • Guard plugin-add against git transport-helper URLs by @bastidotnet in #8067
  • Stop USB device names from being executed as Hyprland Lua by @acrogenesis in #8129
  • Pin trusted PATH in privileged DNS helper by @mdisec in #8172
  • Refuse the git transports Omarchy does not clone from by @omarchybot in #8174

Fixes

  • Fix Windows VM launch never opening an RDP window by @DataDave-Dev in #6893
  • Fix o.shell_succeeds() always returning false inside Hyprland by @dhh in #6939
  • Repair foot.ini configs holding a literal \n[text-bindings] line by @dhh in #6938
  • Keep mise wrappers from writing to stdout by @dhh in #6940
  • Stop the bar sticking in move mode after a press-and-hold on a widget by @dhh in #6943
  • Fix Clone Plugin failing with "unknown clone option" by @dhh in #6942
  • Keep the calendar's day names in English by @dhh in #6988
  • Format the whole speed test dial for the locale by @dhh in #6994
  • Fix passwordless OWE Wi-Fi handling by @dhh in #7238
  • Decode UTF-16 text in clipboard history by @dhh in #7249
  • Decode mixed UTF-16 clipboard text by @dhh in #7466
  • Show a theme's webp background instead of a blank desktop and lock screen by @omarchybot in #7477
  • Switch DNS providers without a password prompt by @omarchybot in #7472
  • Fall back to polkit when the DNS sudoers grant is missing by @dhh in #7492
  • Leave an auto-scaled internal panel alone in clamshell recovery by @fuchsblau in #7581
  • Only offer Update > Extra Themes when there is one by @omarchybot in #7775
  • Stop a psmouse quirk from failing every install by @omarchybot in #7236
  • Wait for the keypress ourselves instead of asking gum to by @dhh in #8082
  • Offer to reboot when toggling sudoless Docker; show only the relevant menu entry by @omarchybot in #8098
  • Let a received Taildrop file wait to be answered by @omarchybot in #7953

New Contributors

Full Changelog: https://github.com/basecamp/omarchy/compare/v4.0.0...v4.0.1

Changes since v4.0.0

Full diff: 6 commands added, 1 removed; 0 keybindings added, 0 removed.

Removed commands: omarchy-sudo-reset

Migrations this upgrade ran (8)

Each is a script that ran once on your machine during omarchy update. Descriptions are the scripts' own messages.

  • 2026-08-15 Remove the literal \\n[text-bindings] line an earlier migration wrote into foot.ini src
  • 2026-08-17 Switch mise to the mise-bin package from the Omarchy repo src
  • 2026-08-19 Add webp decoding to the shell src
  • 2026-08-22 Switch back to the packaged quickshell now that 0.3.1 kills synchronously src
  • 2026-08-23 Re-stage the current theme so an installed theme's code is dropped src
  • 2026-08-23 Take ownership of the FIDO2 authfile so it cannot be rewritten without root src
  • 2026-08-24 Move this install to the opt-in docker group default (the group is root-equivalent) src
  • 2026-08-25 Store Hyprland input-device names as data instead of generated Lua src

Unofficial mirror of public release data. Notes 漏 the Omarchy authors (MIT repository). Bare #numbers are linked to the upstream issue tracker.