
How to Connect to Wifi on Hyprland? Quick Hyprland Network Setup
Introduction If you have just installed Hyprland and booted into your shiny new Wayland compositor, you may have noticed something immediately: there is no network icon in the corner, no system tray applet waiting to connect you, and your browser simply refuse
Introduction
If you have just installed Hyprland and booted into your shiny new Wayland compositor, you may have noticed something immediately: there is no network icon in the corner, no system tray applet waiting to connect you, and your browser simply refuses to load. That is because Hyprland is intentionally minimal. It ships as a compositor only, leaving networking, authentication agents, and status bars entirely up to you. For many users, the first real task after installation is figuring out How to Connect to Wifi on Hyprland? This guide answers that question completely, walking you through every common method so you can pick the one that fits your workflow.
Whether you prefer typing commands in a terminal, using a text-based user interface, or clicking through a graphical applet in your Waybar, Hyprland supports all of these approaches. The key is understanding which tools are available, how they interact with Wayland, and how to make your chosen solution persist across reboots. By the end of this article, you will have a fully working wireless connection and a clear understanding of how to manage networks on Hyprland going forward.
Table of Contents
- Introduction
- What Is Hyprland and Why Does Networking Differ?
- Prerequisites Before You Begin
- Choosing a Network Manager for Hyprland
- Comparison of Networking Tools
- Method 1: Using NetworkManager and nmcli
- Method 2: Using nmtui
- Method 3: Using iwd and iwctl
- Method 4: Using wpa_supplicant
- Method 5: GUI Applets and Waybar Integration
- Connecting to Hidden Networks
- Troubleshooting Common Issues
- Tips and Best Practices
- Frequently Asked Questions
- Conclusion
What Is Hyprland and Why Does Networking Differ?
Hyprland is a dynamic tiling Wayland compositor known for its smooth animations, extensive configuration options, and minimal base installation. Unlike desktop environments such as GNOME or KDE Plasma, Hyprland does not bundle a network manager, a system tray, or a settings panel. This design philosophy keeps the compositor fast and unopinionated, but it also means you must install and configure networking tools yourself.
On X11-based desktops, you might rely on NetworkManager’s applet in the system tray. On Hyprland, because it runs on Wayland, traditional X11 tray icons do not work unless you run an XWayland compatibility layer or use Wayland-native alternatives. This is why many new users ask How to Connect to Wifi on Hyprland? right after their first boot. The good news is that the underlying networking stack is identical to any other Linux system. Tools like NetworkManager, iwd, and wpa_supplicant all work perfectly; you simply need to invoke them correctly.
Prerequisites Before You Begin
Before connecting to any wireless network, verify a few basics. First, ensure your wireless adapter is recognized by the kernel. You can check this by running the following command in your terminal:
ip link show
Look for an interface named something like wlan0, wlp2s0, or wlp3s0. If no wireless interface appears, you may need to install firmware packages such as linux-firmware or a driver specific to your hardware. On Arch Linux, which is the most common base for Hyprland installations, you can install firmware with:
sudo pacman -S linux-firmware
Second, make sure you have either an Ethernet cable temporarily available or a phone USB tethering connection. This lets you install packages while you configure wireless. Third, confirm that the NetworkManager service is installed and running if you plan to use it. You can enable and start it with:
sudo systemctl enable --now NetworkManager
With these prerequisites in place, you are ready to explore the actual connection methods.
Choosing a Network Manager for Hyprland
There is no single correct answer to How to Connect to Wifi on Hyprland? because different users prefer different workflows. Some want the simplicity of a graphical applet, while others prefer the speed of command-line tools. The most common choices are NetworkManager with nmcli or nmtui, iwd with iwctl, and wpa_supplicant. NetworkManager is the most popular because it integrates well with many tools and supports both wired and wireless connections seamlessly. iwd is a modern, lightweight alternative that boots faster and consumes fewer resources. wpa_supplicant is the traditional low-level tool and is usually wrapped by NetworkManager or iwd anyway.
Comparison of Networking Tools
The table below summarizes the most common networking tools you can use on Hyprland. Use it to decide which approach best matches your needs.
| Tool | Interface Type | Resource Usage | Best For | Auto-Connect on Boot |
|---|---|---|---|---|
| NetworkManager (nmcli) | Command line | Moderate | Power users who script connections | Yes |
| NetworkManager (nmtui) | Text UI | Moderate | Interactive terminal setup | Yes |
| iwd (iwctl) | Command line | Low | Minimal, fast-boot systems | Yes, with configuration |
| wpa_supplicant | Config file | Low | Advanced manual control | Manual setup required |
| nm-applet / Waybar module | Graphical | Moderate | Users wanting click-to-connect | Yes |
Method 1: Using NetworkManager and nmcli
NetworkManager is the default on most distributions and the recommended starting point. The nmcli command lets you manage connections entirely from the terminal, which makes it ideal for Hyprland users who want a fast, scriptable workflow. Here is how to connect step by step.
Scan for Available Networks
First, ensure NetworkManager is running. Then scan for Wi-Fi networks with:
nmcli device wifi list
This prints a table of SSIDs, signal strength, security type, and channel. Note the exact SSID of the network you want.
Connect to a Network
To connect to a standard WPA2 or WPA3 network, use:
nmcli device wifi connect "Your_SSID" password "Your_Password"
Replace Your_SSID and Your_Password with your actual network name and passphrase. NetworkManager will create a connection profile automatically and connect immediately. If the connection succeeds, you will see a confirmation message, and your interface will receive an IP address.
Verify the Connection
Confirm connectivity by pinging a reliable host:
ping -c 4 archlinux.org
If packets are received, you are online. NetworkManager saves the profile, so on future boots it will reconnect automatically as long as the service is enabled.
Managing Saved Connections
You can list saved profiles with nmcli connection show, delete one with nmcli connection delete "Profile_Name", and manually activate a saved profile with nmcli connection up "Profile_Name". This level of control is why many users answer How to Connect to Wifi on Hyprland? with “use nmcli” as their first recommendation.
Method 2: Using nmtui
If you prefer an interactive interface but still want to stay in the terminal, nmtui is a text-based user interface built into NetworkManager. Launch it by typing:
nmtui
You will see a simple menu with options to activate a connection, edit connections, or set the system hostname. Choose “Activate a connection,” select your wireless interface, pick your SSID from the list, and enter the password when prompted. nmtui is especially helpful if you are unsure of the exact command syntax or want to browse networks visually without leaving the terminal. It uses the same underlying NetworkManager profiles, so auto-connect behavior is identical to nmcli.
Method 3: Using iwd and iwctl
iwd, the iNet Wireless Daemon, is a modern alternative to wpa_supplicant. It is faster, has a smaller footprint, and is increasingly popular among minimal Hyprland setups. To use it, install iwd and enable its service:
sudo pacman -S iwd
sudo systemctl enable --now iwd
Then launch the interactive client:
iwctl
Inside iwctl, first list your devices:
device list
Identify your wireless device, often wlan0. Then scan for networks:
station wlan0 scan
View the results:
station wlan0 get-networks
Connect to your chosen network:
station wlan0 connect "Your_SSID"
You will be prompted for the passphrase. iwd stores credentials securely and reconnects automatically on boot if configured to do so. For users who value speed and minimalism, this is a strong answer to How to Connect to Wifi on Hyprland?
Method 4: Using wpa_supplicant
wpa_supplicant is the traditional, low-level tool for WPA authentication. It is rarely used directly on modern desktops because NetworkManager and iwd wrap it, but it remains useful for advanced users who want precise control. A typical setup involves creating a configuration file at /etc/wpa_supplicant/wpa_supplicant.conf with a network block:
network={
ssid="Your_SSID"
psk="Your_Password"
}
Then run wpa_supplicant against your interface and request an IP via DHCP:
sudo wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant/wpa_supplicant.conf
sudo dhcpcd wlan0
This method requires more manual management and is generally not recommended unless you have a specific reason, such as running a very stripped-down system without NetworkManager.
Method 5: GUI Applets and Waybar Integration
Many Hyprland users run Waybar as their status bar and want a clickable network icon. Because Hyprland is Wayland-based, you should use Wayland-compatible applets. The most common is nm-applet running under XWayland, or a native Waybar network module. To use nm-applet, install it and add it to your Hyprland autostart:
exec-once = nm-applet --indicator
In your hyprland.conf, this line launches the applet on boot. It appears as a tray icon if you have a Wayland-compatible tray such as Waybar with tray support enabled. Alternatively, Waybar’s built-in network module displays connection status and can be configured to show signal strength and SSID. While clicking may only show status rather than full management, pairing Waybar with nmcli or nmtui gives you both visual feedback and full control.
Connecting to Hidden Networks
Hidden SSIDs do not broadcast their name, so scanning will not reveal them. With NetworkManager, you can connect directly by specifying the SSID:
nmcli device wifi connect "Hidden_SSID" password "Your_Password" hidden yes
With iwd, you can also connect by exact name even if it is not listed. For wpa_supplicant, simply add the network block with the exact SSID. Hidden networks require you to know the precise name and security type, so double-check with your router’s admin panel if unsure.
Troubleshooting Common Issues
Even with correct commands, things can go wrong. Here are the most frequent problems and their fixes.
- No wireless interface found: Install
linux-firmwareand reboot. Checkdmesg | grep -i wififor driver errors. - NetworkManager not running: Enable and start it with
sudo systemctl enable --now NetworkManager. - Connection fails with authentication error: Verify your password carefully. Some routers use WPA3; ensure your tool supports it. NetworkManager and recent iwd both support WPA3.
- Connected but no internet: Check DNS with
resolvectl status. Restart NetworkManager or trysudo systemctl restart NetworkManager. - Applet not appearing in Waybar: Ensure Waybar is built with tray support and that
nm-appletis running under XWayland. Check Hyprland logs for errors. - Slow connection or frequent drops: Try switching the regulatory domain with
iw reg setor disable power saving withiwconfig wlan0 power off.
These steps resolve the majority of issues users encounter when asking How to Connect to Wifi on Hyprland? for the first time.
Tips and Best Practices
- Enable NetworkManager or iwd at boot so connections persist.
- Use connection profiles with priorities if you have multiple networks.
- Keep firmware updated, especially for newer Wi-Fi 6 and 6E adapters.
- Prefer WPA3 where your router supports it for better security.
- Store passwords in a secret service like GNOME Keyring or KWallet if using applets.
- Test your connection after every system update, as kernel upgrades can affect drivers.
- Document your chosen method in your Hyprland config comments for future reference.
Frequently Asked Questions
Do I need NetworkManager on Hyprland?
No. Hyprland does not require any specific network tool. You can use iwd, wpa_supplicant, or even systemd-networkd. NetworkManager is simply the most convenient and widely supported option.
Why does my Wi-Fi work on other desktops but not Hyprland?
The hardware and drivers are the same. The difference is that Hyprland does not start a network manager automatically. You must install and enable one yourself.
Can I use a graphical network applet on Wayland?
Yes, but you may need XWayland compatibility or a native Wayland applet. nm-applet works under XWayland, and Waybar’s network module provides status display.
How do I make Wi-Fi connect automatically on boot?
Enable your network manager service with systemctl and ensure the connection profile is set to auto-connect. NetworkManager does this by default for saved profiles.
Is iwd better than NetworkManager?
It depends. iwd is lighter and faster, but NetworkManager offers broader compatibility, VPN support, and easier integration with applets. Many users run iwd as the backend with NetworkManager on top.
What if my adapter is not supported?
Check the Arch Wiki for your specific chipset. You may need a DKMS driver or firmware package. USB Wi-Fi adapters with well-supported chipsets are a reliable fallback.
Conclusion
Answering How to Connect to Wifi on Hyprland? comes down to choosing the right tool for your workflow and enabling it properly. For most users, NetworkManager with nmcli or nmtui provides the best balance of power and simplicity. Minimalists may prefer iwd, while those wanting graphical control can integrate nm-applet with Waybar. Regardless of the method, the core steps remain the same: verify your adapter, install and enable a network manager, scan and connect, then confirm connectivity. Once configured, your connection will persist across reboots and you can focus on enjoying the speed and customization that Hyprland offers. With the methods and troubleshooting tips in this guide, you should now have a reliable wireless setup and the knowledge to maintain it long-term.