Omarchy uses NetworkManager (plus iwctl fallback) and BlueZ. Most fixes live in nmtui or Hyprland keybinds, not manual wpa_supplicant.

Quick connect

WiFi via UI: Super + Space → Network / WiFi → scan, or:

nmcli device wifi list
nmcli device wifi connect "SSID" password "pass"
nmtui  # curses UI for hidden SSIDs, VPN import

iwctl emergency (no NetworkManager):

iwctl
station wlan0 scan
station wlan0 get-networks
station wlan0 connect SSID

Bluetooth:

bluetoothctl
power on
scan on
pair  XX:XX:XX:XX:XX:XX
trust XX:XX:XX:XX:XX:XX
connect XX:XX:XX:XX:XX:XX

UI: top bar speaker/Bluetooth → settings.

VPN

• Import .ovpn / WireGuard conf via nmtui → Add → WireGuard/OpenVPN.
• Or nmcli connection import type wireguard file wg0.conf.

Mullvad/Tailscale one-liners work as on Arch; they just appear as NM devices.

7 common fixes

1. Offline after install → sudo systemctl enable --now NetworkManager; sudo systemctl enable --now iwd only if you use iwd, not both.
2. Slow pacman downloads → Mirrors/DNS. See Fix Slow Pacman: sudo pacman-mirrors -f 5 alternative reflector -c IL -a 6 --sort rate | sudo tee /etc/pacman.d/mirrorlist.
3. Captive portal not popping → sudo nmcli connection modify "SSID" ipv4.dns-priority 1 and open http://detectportal.firefox.com.
4. Bluetooth audio not default → Top bar speaker → Volume → set sink as default (d). Or pactl set-default-sink bluez_output....
5. WiFi sees no networks → rfkill list, rfkill unblock wifi, check BIOS wireless enabled.
6. VPN kills DNS → sudo resolvectl dns tun0 1.1.1.1, or set DNS inside NM connection → IPv4 → DNS 1.1.1.1.
7. Ethernet + WiFi both on → Set ipv4.route-metric 200 for WiFi lower priority than Ethernet 100 in NM editor.

Check logs: nmcli device status, journalctl -u NetworkManager --since today, dmesg | grep -i firmware for missing wifi firmware.

Manual: Omarchy Networking.