The field guide / 04

Fixes11

Eleven remedies from the troubleshooting chapter of the Omarchy manual.

About this collection & its sources

manual/45-troubleshooting.md on the quattro branch has seven headings. Three of those headings contain more than one remedy, and those remedies are separate entries here. The other four headings are one entry each.

From “I broke my system with an update!”

Roll back to the version before a recent update

The troubleshooting chapter says to roll the system back to the version before a recent update before trying anything else.

From “I broke my system with an update!”

Share omarchy-debug on #omarchy-help

If a rollback does not repair an update, the troubleshooting chapter says to run omarchy-debug and share it on #omarchy-help in Discord.

From “I broke my system with an update!”

Reinstall default configs and packages

The troubleshooting chapter says omarchy-reinstall reinstalls the default configs and packages when a rollback and a debug report are not enough.

From “Why are some apps so large on my display?”

Set the GDK scale to 1 on a 1x display

The manual says Omarchy assumes a 2x display and tells 1x displays to change omarchy_gdk_scale from 2 to 1 in monitors.lua.

From “Why are some apps so large on my display?”

Shrink the Spotify UI with Ctrl + Minus

The troubleshooting chapter says Spotify can be shrunk with Ctrl + Minus and enlarged with Ctrl + Plus.

From “My Wi-Fi, Bluetooth, audio, or trackpad just stopped working”

Restart Wi-Fi, Bluetooth, audio, or the trackpad

Before rebooting, the manual says to reload Wi-Fi, Bluetooth, Audio, or Trackpad from Update > Hardware.

From “Why are my external speakers not playing?”

Choose the external speakers in the volume popup

The manual says silent external speakers are usually not the primary output, and the speaker icon opens the output picker.

From “My laptop speakers sound off”

Turn laptop speaker tuning off

The manual says some laptops get an automatic speaker tuning, and omarchy audio tuning off disables it.

From “Why can't I login or sudo with my password?”

Reset a password lockout with faillock

The manual says repeated bad passwords can lock a login, and faillock --reset clears it from a root TTY.

From “Why isn't my 1Password authorization prompts for 1Password SSH Agent / CLI appearing?”

Turn on 1Password hardware acceleration

The manual says the rich 1Password approval prompt needs Settings > Advanced > Use Hardware Acceleration, then a reboot.

From “Why isn't my 1Password authorization prompts for 1Password SSH Agent / CLI appearing?”

Launch 1Password after boot

The manual says the 1Password approval prompt does not appear if 1Password has not been launched since boot.