Open a hotel or airport Wi-Fi login page that never pops up
Confirmed on this workstation (4.0.4-1, upstream latest v4.0.4) that nothing under /usr/share/omarchy mentions captive, portal or nm-check, so 4.0.4 has no handler, and /usr/lib/NetworkManager/conf.d/20-connectivity.conf sets uri=http://ping.archlinux.org/nm-check.txt. On quattro, shell/plugins/panels/network/Model.js line 41 hardcodes captivePortalUrl to that URL and Panel.qml opens it through omarchy-launch-browser. The record names the wrong control: the panel button is labelled "Open Captive Portal" (Panel.qml line 1368), under a "SIGN-IN REQUIRED" heading, and "Sign in to this network" is only a tooltip text (line 1082). Issue #11961 uses the tooltip wording, so symptom and cause are corrected to the real label. NetworkManager's polkit policy gives org.freedesktop.NetworkManager.reload auth_admin_keep with no wheel rule, so the unprivileged nmcli general reload conf would stop for authentication, and the fix now runs it with sudo. The nmcli monitor string "Connectivity is now '%s'" was confirmed in src/nmcli/general.c and is wrapped in _(), so LC_ALL=C is right. The Arch wiki gives exactly the nmcheck.gnome.org example and the /etc override of the same file name. Issue #9610 supports the neverssl.com workaround, the IPv6 blackhole note and the user service shape. Not exercised: no portal was available to test the watcher.
Switching to omarchy dns DHCP sends DNS in plaintext to whatever resolver the portal network hands out, which on a hostile network can log or rewrite lookups. Switch back with omarchy dns Cloudflare once you are through.
Symptom
You join hotel, train, airport or cafe Wi-Fi. The bar shows Wi-Fi connected, but nothing loads and no login page ever appears, unlike on a phone, macOS or GNOME. nmcli networking connectivity check prints portal or limited. On builds whose network panel has an "Open Captive Portal" button under a "SIGN-IN REQUIRED" heading (the quattro branch, not 4.0.4), clicking it can open a plain text page from ping.archlinux.org instead of the portal's login form.
Cause
Omarchy 4.0.4, the current release, ships no captive portal handler at all. NetworkManager does detect the portal: Arch's networkmanager package configures /usr/lib/NetworkManager/conf.d/20-connectivity.conf with uri=http://ping.archlinux.org/nm-check.txt, and when that probe is intercepted NetworkManager sets its connectivity state to portal. Nothing in the Omarchy shell or in a dispatcher script reacts to that state by opening a browser, so you are expected to know to browse to a plain HTTP site yourself (upstream issue #9610).
The quattro branch adds an "Open Captive Portal" button to the network panel (its tooltip reads "Sign in to this network"), but shell/plugins/panels/network/Model.js hardcodes captivePortalUrl = "http://ping.archlinux.org/nm-check.txt". Issue #11961 reports that many portals only intercept the probe URLs that phones and desktop OSes use, so the button can load Arch's check file instead of the login page.
A second, independent cause stops the portal from loading even when you do open a browser: omarchy dns Cloudflare (the default) pins DNS so the portal's own DNS hijack never sees your queries. That one is covered by the record captive-portal-never-loads-forced-dns.
Fix
Immediate workaround. Open a plain HTTP page, which a portal must intercept to redirect you:
xdg-open http://neverssl.com/
If that still loads nothing, check DNS first, because a pinned resolver blocks the redirect:
omarchy dns # prints the current provider
omarchy dns DHCP # use the network's DNS while on this portal
Switch back later with omarchy dns Cloudflare. Some portals intercept IPv4 only and blackhole IPv6, which hangs the browser instead of redirecting. If so, turn IPv6 off for that one profile:
nmcli connection modify "<SSID>" ipv6.method disabled
nmcli connection up "<SSID>"
Optional, so NetworkManager detects more portals correctly. Point its check at a URL portals commonly recognise. This is the example the Arch wiki gives:
sudo tee /etc/NetworkManager/conf.d/20-connectivity.conf >/dev/null <<'EOF'
[connectivity]
uri=http://nmcheck.gnome.org/check_network_status.txt
EOF
sudo nmcli general reload conf
The file name matches the packaged one under /usr/lib/NetworkManager/conf.d/, so the copy in /etc replaces it. Note that the panel button on quattro ignores this setting and keeps opening its hardcoded URL.
Optional, to open the login page automatically. A user service that watches NetworkManager and opens a browser when connectivity becomes portal. It runs in the graphical session so xdg-open has a display:
mkdir -p ~/.local/bin ~/.config/systemd/user
cat > ~/.local/bin/captive-portal-watch <<'EOF'
#!/bin/bash
# Open a login page whenever NetworkManager reports a captive portal.
while true; do
LC_ALL=C nmcli monitor | while read -r line; do
case "$line" in
*"Connectivity is now 'portal'"*) xdg-open http://neverssl.com/ >/dev/null 2>&1 ;;
esac
done
sleep 2
done
EOF
chmod +x ~/.local/bin/captive-portal-watch
cat > ~/.config/systemd/user/captive-portal-watch.service <<'EOF'
[Unit]
Description=Open captive portal login pages
After=graphical-session.target
PartOf=graphical-session.target
[Service]
ExecStart=%h/.local/bin/captive-portal-watch
Restart=always
[Install]
WantedBy=graphical-session.target
EOF
systemctl --user daemon-reload
systemctl --user enable --now captive-portal-watch.service
LC_ALL=C matters because nmcli translates the message under a non-English locale. The service only fires when NetworkManager's own check reports portal. Portals that silently drop traffic instead of redirecting report limited and still need the manual neverssl.com step.
Verify
nmcli networking connectivity check # portal before login, full after
systemctl --user status captive-portal-watch.service
resolvectl dns # on a portal, the Wi-Fi link should list the network's DNS server
After signing in, curl -sI http://neverssl.com/ returns 200 from neverssl itself rather than a redirect.
Sources
- https://github.com/omacom/omarchy/issues/9610
- https://github.com/omacom/omarchy/issues/11961
- https://github.com/omacom/omarchy/blob/quattro/shell/plugins/panels/network/Model.js
- https://wiki.archlinux.org/title/NetworkManager
- https://gitlab.freedesktop.org/NetworkManager/NetworkManager/-/blob/main/src/nmcli/general.c
- https://github.com/omacom/omarchy/blob/quattro/shell/plugins/panels/network/Panel.qml