OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
power-suspend low occasional DISPUTE

Bring back the Suspend entry in the Omarchy system menu

omarchyhyprlandlaptopdesktop
CORRECTED An auditor found the fix wrong or incomplete and rewrote it. · checked against Omarchy omarchy 4.0.4-1 on 2026-10-05
AUDIT NOTE

The menu entry, its when guard and the flag path are right (read /usr/share/omarchy/default/omarchy/omarchy-menu.jsonc, omarchy-toggle-enabled and omarchy-toggle). Three defects. First, the fix runs omarchy-toggle-suspend unconditionally after the ls check, and that script flips the flag, so a reader whose flag is absent hides Suspend by following the fix. omarchy-toggle suspend-off off removes it idempotently. Second, the cause's history is wrong: issue #3928 was closed by DHH pointing at commit fc04525, which REMOVED Suspend on purpose ('Suspend is not properly supported on a lot of computers'), and it was not restored by a fix. It came back as an opt-in suspend-on toggle in January 2026 and became opt-out in commit e140badb, whose migration 1771683296.sh created suspend-off for every user who had not opted in. That migration is the likeliest source of a carried-over flag. Third, the symptom omitted Screensaver, which the menu always shows. Also confirmed that the menu plugin (shell/plugins/menu/Menu.qml) re-evaluates guards on every open and merges ~/.config/omarchy/extensions/omarchy-menu.jsonc over the default, so a user extension is a second way to lose the entry. Nothing was toggled on this machine.

The cause above was rewritten on 2026-10-05 to match this note; the fix was corrected by the audit itself.

Symptom

The Omarchy system menu (Super+Escape, or the power key) shows Screensaver, Lock, Logout, Reboot and Shutdown, and maybe Hibernate, but no Suspend. systemctl suspend from a terminal still works.

Cause

On Omarchy 4 the Suspend entry is defined in /usr/share/omarchy/default/omarchy/omarchy-menu.jsonc with "when":"! omarchy-toggle-enabled suspend-off". It is hidden whenever the flag file ~/.local/state/omarchy/toggles/suspend-off exists, and shown by default when it does not. omarchy-toggle-suspend flips that file, so a single run of it hides Suspend. The flag is also often carried over from Omarchy 3. Omarchy 3.2.3 removed Suspend from the menu on purpose (commit fc04525, "Suspend is not properly supported on a lot of computers", referenced when issue #3928 was closed). A January 2026 commit brought it back as an opt-in suspend-on toggle, and commit e140badb in February 2026 made it opt-out with migration 1771683296.sh, which created suspend-off for every user who had not opted in. A home directory that went through that migration still hides Suspend. A user menu extension at ~/.config/omarchy/extensions/omarchy-menu.jsonc is merged over the default and can also redefine the entry. Hibernate is a separate entry, shown only when omarchy-hibernation-available succeeds.

Fix

**Omarchy 4:** check for the flag, then clear it with the explicit off form:


ls ~/.local/state/omarchy/toggles/suspend-off 2>/dev/null && echo 'suspend hidden'
omarchy-toggle suspend-off off

omarchy-toggle suspend-off off removes the flag and does nothing if it is already absent. Do not run omarchy-toggle-suspend blind: it flips the flag, so on a machine without the flag it hides Suspend. The menu re-evaluates its when guards every time it opens, so nothing needs restarting.

If the flag is absent and Suspend is still missing, look for a user menu extension that redefines the entry:


grep -n 'system.suspend' ~/.config/omarchy/extensions/omarchy-menu.jsonc 2>/dev/null

Remove or fix that entry in the extension file.

If Suspend appears but does nothing, the problem is suspend itself, not the menu. See suspend-blocked-by-inhibitor-lock.

If **Hibernate** is the missing entry, see hibernate-blocked-by-zram-only-swap. It needs disk swap larger than /sys/power/image_size and /etc/mkinitcpio.conf.d/omarchy_resume.conf.

Verify

ls ~/.local/state/omarchy/toggles/suspend-off reports no such file, and Super+Escape shows Suspend.

Sources

omarchy-suspend-missing-from-system-menu