Connect to Wi-Fi in Omarchy
Join a wireless network, confirm internet access, and know when to switch to troubleshooting.
Based on public documentation; not hardware-tested. Match the instructions to your version and hardware.
Connect from the desktop
Section titled “Connect from the desktop”The current Omarchy networking guide uses NetworkManager. Open the network panel from the top bar or press Super + Ctrl + W.
- Check that Wi-Fi is enabled and airplane mode is off.
- Select your network name from the scan results.
- Enter the network’s password when prompted.
- Wait for the connection status, then open a familiar website.
Use the password for the network, not your Omarchy login. A campus or workplace network can require an identity, certificate, or other settings supplied by its administrator.
Use the terminal interface if needed
Section titled “Use the terminal interface if needed”Open a terminal with Super + Enter, then run:
nmtuiUse its connection interface to select and activate your wireless network, supplying authentication when requested. This is an alternative interface to the same network manager, not a second networking service.
Confirm what “connected” means
Section titled “Confirm what “connected” means”A connection to the access point does not guarantee internet access. Compare a second website and another device on the same network. Hotel or guest Wi-Fi may require a sign-in page. If an expected portal appears, complete the network’s normal sign-in flow.
For a useful comparison, try a phone hotspot if you have one. Note whether the same laptop works there. Do not change DNS and install another network manager simultaneously: you would lose track of which change mattered.
Reconnect after restarting
Section titled “Reconnect after restarting”Once connected, save your work and check that the expected network is available after a restart. If the adapter disappears only after sleep, see sleep troubleshooting.
For no adapter, repeated password rejection, or a connected network without internet, continue with Wi-Fi troubleshooting. Record the symptom and comparison results.
Share access deliberately
Section titled “Share access deliberately”Setup → Network → QR Code can display connection details for another device to scan. Treat that QR code like the Wi-Fi password: keep it out of public screenshots and bug reports.