Setting up WiFi in Debian: From Drivers to a Stable Connection

operating system Debian It's renowned for its stability and conservative approach to software selection, which often leads to difficulties when working with the latest networking equipment. Unlike more user-friendly distributions, it wireless connection It doesn't always activate automatically immediately after installation, requiring manual intervention from the user. This is especially true for proprietary modules, which are not included in the repositories by default due to licensing policy.

The situation changed dramatically with the release of version Debian 12 "Bookworm", where unofficial firmware repositories have finally been added directly to the standard installer. The process has become significantly simpler, but still requires a basic understanding of the operating principles. network interfaces In Linux. If you're used to Windows graphical interfaces, the command line may seem intimidating, but it gives you complete control over the connection.

In this guide, we'll walk you through everything from identifying your network card to setting up a static IP address. You'll learn how to avoid common mistakes and why. lack of firmware package is the most common cause of non-working WiFi. We'll cover both classic terminal methods and modern graphical utilities.

Identifying the network adapter and checking the drivers

The first step before doing anything is to accurately determine the model of your network adapter. There are many tools for this in Linux, but the most informative utility is lspci for internal cards or lsusb For external USB dongles, run the command in Terminal with root privileges to see detailed information about the connected device.

Pay attention to the lines containing the words Wireless, Network or names of manufacturers like Realtek, Intel, BroadcomThis is the data we need to find the appropriate microcode package. Beginners often skip this step and try to install drivers at random, which leads to system conflicts.

If the team ip link shows the interface but it is labeled as NO-CARRIER or is missing from the list of network connections, the problem lies deeper. Most likely, the system kernel sees the device but cannot initialize it without additional proprietary code.

⚠️ Note: On some laptops with dual graphics cards or complex power architectures, the WiFi module may be disabled at the BIOS/UEFI level. Check your power saving settings if the device is not detected at all.

For users of older versions of Debian, in such cases the only option is to use a USB flash drive from an Android smartphone or a temporary connection via an Ethernet cable.

Installing firmware and necessary packages

Starting from Debian 12, the firmware installation procedure has become trivial, but requires adding a repository non-free-firmware to the list of sources. Open the file /etc/apt/sources.list and make sure that the lines with your repositories contain the words non-free And non-free-firmwareWithout this step, the system simply won't see the necessary files.

After updating the package list with the command apt update You need to install a meta-package that will automatically pull in all the necessary dependencies for your hardware. For most modern Intel and Realtek cards, installing the package is sufficient. firmware-iwlwifi or firmware-realtek respectively.

sudo apt install firmware-iwlwifi firmware-misc-nonfree

It's important to understand the difference between open-source drivers, which are already built into the kernel, and proprietary blobs (firmware), which are loaded separately. It's the latter component that's most often missing from minimalist Debian installations.

The table below lists the most common manufacturers and the corresponding packages that may be required for proper operation:

After installing the packages, be sure to reboot the system or rebuild the image. initramfs team update-initramfs -u, so that the changes take effect before the graphical shell is loaded.

Configuration via NetworkManager (Graphical Interface)

For most users of desktop versions of Debian, the optimal solution is to use NetworkManagerThis service manages connections, automatically switching between known networks and handling password requests. In graphical environments like GNOME or KDE Plasma Its interface is accessible through the system tray.

To connect to a network, click the network icon in the upper-right corner of the screen and select your access point from the list. If the network is hidden, select "Connect to a hidden network" and manually enter it. SSID (network name). The system will automatically determine the encryption type, usually it is WPA2 or WPA3.

Corporate networks or those with specific requirements may require configuring a static IP address. To do this, go to the IPv4 tab in the connection settings and change the method from "Automatic (DHCP)" to "Manual." Here you will need to specify the IP address, subnet mask, gateway, and DNS servers.

⚠️ Important: When manually setting an IP address, make sure the selected address is not in the DHCP range of your router. Otherwise, an address conflict will occur and the Internet will be lost for all devices.

NetworkManager also lets you create profiles for different locations. For example, you can set up one profile for your home with a static IP address and another for your office with a proxy server, and switch between them with a single click.

Managing WiFi via Terminal (nmcli)

For server versions of Debian or minimalist enthusiasts, the utility is an indispensable tool. nmcli (NetworkManager Command Line Interface). It allows you to perform all the same actions as the graphical interface, but using text commands. This is especially useful for remote administration via SSH.

To get started, you need to turn on the WiFi adapter if it is turned off. Command nmcli radio wifi on activate the wireless module. Then scan for available networks with the command nmcli dev wifi listto see surrounding access points and their signal strength.

sudo nmcli dev wifi connect "Network_Name" password "Your_Password"

This command will create a new connection and automatically attempt to obtain an IP address. If the connection is successful, you'll see an activation message. If an error occurs, the system will return a reason code, which can be deciphered in the documentation.

To view the details of the current connection, use the command nmcli con show --active. All active profiles are displayed here, including wired and virtual interfaces. You can delete a saved profile with the command nmcli con delete "Profile_Name", which is useful if you have changed your router password.

Nmcli Secrets

The command "nmcli -f active,device SSID" will only show the name of the currently active WiFi network, which is convenient for quick monitoring scripts.

Usage nmcli gives you the flexibility to create complex scenarios, such as automatically connecting to a specific network only at a specific time of day or when connecting to a specific USB device.

Troubleshooting Realtek and Broadcom Drivers

Devices from Realtek And Broadcom have historically caused the most trouble for Linux users due to the lack of official support in the mainline kernel. Often, standard packages firmware do not contain current microcode versions for new adapter models released in 2026-2026.

In such cases, the only solution is to compile the drivers from source code. You will need to install the package build-essential and kernel header files linux-headers-$(uname -r)Driver source codes can usually be found on GitHub in community repositories, such as the project rtl88x2bu or bcma.

⚠️ Warning: When compiling third-party drivers, always check the repository's last update date. Using abandoned code on the new Debian kernel may result in system instability or kernel panics.

The installation process typically consists of a series of commands: cloning the repository, running the build script, and installing the module. After that, you need to manually add the module name to the file. /etc/modulesso that it loads at system startup.

If the network keeps coming and going after installing the driver, try disabling power saving mode. Create a configuration file in /etc/NetworkManager/conf.d/default-wifi-powersave-on.conf and set the value wifi.powersave V 2 (which means turning off savings).

Signal diagnostics and optimization

Even with properly installed drivers, connection quality may still be poor. Use the following utility for diagnostics: iwquality or built-in tools nmcli. Team watch -n 1 nmcli dev wifi will allow you to monitor the signal level and connection quality in real time.

Channel congestion is a common problem in apartment buildings. With the help of the team sudo iwlist wlan0 scan | grep -i channel You can analyze which channels are occupied by neighboring routers. Switching your router to a free channel (for example, 1, 6, or 11 for 2.4 GHz) can significantly improve speed.

To force switching to the 5 GHz band, which is less crowded but has a shorter range, use the command nmcli con modify "Name" 802-11-wireless.band aThis is relevant if your adapter is dual-band, but the system stubbornly clings to the noisy 2.4 GHz band.

Keep in mind that the physical placement of the antennas also plays a role. Some laptops have WiFi antennas positioned around the screen, so opening the lid can improve the signal, while proximity to metal objects can degrade it.

Hidden command

"sudo iw dev wlan0 link" will show the current connection speed (tx rate) and noise level, which is more useful for diagnostics than just the number of signal "bars".

Frequently Asked Questions (FAQ)

Why doesn't Debian see my WiFi adapter after installation?

Most likely, the system is missing proprietary firmware. Check the adapter model via lspci and install the corresponding package from the repository non-free-firmwareAlso, make sure that the adapter is not disabled by the hardware switch on the laptop case.

How to save a WiFi password in plain text?

NetworkManager stores configurations in files /etc/NetworkManager/system-connections/However, passwords there may be encrypted. To view the password in cleartext, use the command: sudo nmcli -s -g 802-11-wireless-security.psk connection show "Network_Name".

Is it possible to share WiFi with Debian as a router?

Yes, it's possible. The NetworkManager GUI has a "Share to Others" (Hotspot) feature. This can be done via the terminal by creating a new connection with the "Hotspot" mode. mode=ap (Access Point) and setting up Internet access sharing (NAT) via iptables or nftables.

Does the network scanning process use a lot of CPU?

Constant background scanning can consume resources, especially on older laptops. If you're stationary, you can reduce the scanning frequency by adding the following setting: scan_interval in the wpa_supplicant configuration or by disabling scanning in the NM power saving settings.