Distribution Q4OS at the base Debian While Windows is valued for its ease of use, stability, and hardware compatibility, connecting to Wi-Fi can still be a challenge for beginners. If you find that your wireless network isn't working after installing the system, the problem could be missing drivers, incorrect network settings, or a specific issue with your adapter. This article will help you figure out how to enable Wi-Fi in Q4OS Linux — from basic verification to solving complex cases.
We'll cover every step, from hardware diagnostics to manually setting up a connection via the terminal. We'll pay special attention to common errors, such as when the network is visible but doesn't connect, or when the adapter isn't detected by the system at all. If you're using Q4OS on a laptop with Broadcom, Realtek or Intel Wi-Fi, here you will find solutions for your case.
Important: The instructions are valid for Q4OS 5.x (based on Debian 12/11). If you are using an older version, some commands and packages may be different.
1. Checking the presence of a Wi-Fi adapter in the system
Before setting up your network, make sure that The Wi-Fi adapter is recognized by the systemTo do this, run the following command in the terminal:
lspci -knn | grep -iA3 net
In the output, look for lines mentioning Network controller or Wireless. For example:
03:00.0 Network controller [0280]: Intel Corporation Wi-Fi 6 AX200 [8086:2723] (rev 1a)Subsystem: Intel Corporation Wi-Fi 6 AX200NGW [8086:0024]
Kernel driver in use: iwlwifi
If the adapter is not displayed, the problem may be:
- 🔌 Disabled module in BIOS/UEFI (check the settings, especially on laptops Lenovo, HP or Dell).
- 🔧 Hardware failure (try connecting an external USB adapter for testing).
- 🖥️ Lack of drivers (more on this in the next section).
⚠️ Note: On some laptops Lenovo And Acer Wi-Fi can be disabled using a hardware button or combination Fn + F2/F12. Check this before setting up!
2. Installing Wi-Fi drivers in Q4OS
If the adapter is detected but the network does not work, most likely there are no proprietary drivers. Q4OS by default it uses open drivers, which are not always compatible with some chips (especially Broadcom And Realtek).
To install drivers:
- Update package list:
sudo apt update - Install the driver management utility:
sudo apt install q4os-driver-manager - Launch Driver Manager from the application menu or via the command:
sudo q4os-driver-manager
In the manager window, select your adapter and install the recommended driver. Broadcom it's often a package firmware-b43-installer or broadcom-sta-dkms, For Realtek — firmware-realtek.
| Chip manufacturer | Recommended package | Note |
|---|---|---|
| Broadcom | broadcom-sta-dkms |
Requires disabling the open driver b43 through the blacklist |
| Realtek (RTL8188/8192/8723) | firmware-realtek |
You may need to manually download the firmware from the manufacturer's website. |
| Intel | firmware-iwlwifi |
Usually works out of the box, but newer chips (AX200/AX210) require a newer version. |
After installation, reboot the system:
sudo reboot
⚠️ Attention: If after installing the drivers your Wi-Fi stops working completely, revert to the open source driver by uninstalling the proprietary package and rebooting your PC. For example, for Broadcom:sudo apt purge broadcom-sta-dkms
sudo modprobe -r b43 && sudo modprobe b43
☑️ Check Wi-Fi drivers
3. Enabling Wi-Fi via the graphical interface
If the drivers are installed but the network is still not active, check the settings in the graphical interface. Q4OS is used by default NetworkManager (if you didn't remove it during installation).
To turn on Wi-Fi:
- Click on the network icon in the system tray (usually in the upper right corner).
- If there is no icon, run
nm-appletin the terminal:nm-applet & - Find the item in the drop-down menu Turn on Wi-Fi (or
Enable Wi-Fi(in the English version). - Select your network from the list and enter the password.
If the network isn't listed, try refreshing the list of available networks by clicking the refresh button (usually a round arrow). For hidden networks, select Connect to a hidden network and enter SSID manually.
If the Internet doesn't work after connecting, check your settings. DNSSometimes manually specifying DNS from helps. Google (8.8.8.8) or Cloudflare (1.1.1.1) in the connection settings.
4. Setting up Wi-Fi via the terminal (alternative method)
If the graphical interface doesn't work or you prefer the terminal, you can connect to Wi-Fi using the utility nmtui (text interface for NetworkManager) or wpa_supplicant.
Method 1: Using nmtui
- Run the utility:
sudo nmtui - Select "Activate a connection".
- Find your network in the list, select it and click
Enter. - Enter your password and save your settings.
Method 2: Manual connection with wpa_supplicant
This method is useful if NetworkManager It doesn't work. First, check the name of your wireless interface:
ip a
Usually it is wlan0 or wlp3s0. Next:
- Generate config for
wpa_supplicant:wpa_passphrase "NETWORK_NAME" "PASSWORD" | sudo tee /etc/wpa_supplicant.conf - Connect to the network:
sudo wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant.conf - Get an IP address:
sudo dhclient wlan0
To keep the connection after reboot, add wpa_supplicant to startup or configure systemd service.
How to check the Wi-Fi signal strength in the terminal?
Use the command iwconfig wlan0 (replace wlan0 on your interface). Look for the line Signal level - meaning -50 dBm and above is considered a good signal, -70 dBm and below - weak.
5. Solving common Wi-Fi problems
Even after setting up Wi-Fi correctly in Q4OS Errors may occur. Here are the most common ones and how to fix them:
- 🔄 "Connection is activating" endlessly:
The problem is often related to incorrect settings.
IPv6. Try disabling it in the connection settings or add it to/etc/sysctl.conflines:net.ipv6.conf.all.disable_ipv6=1net.ipv6.conf.default.disable_ipv6=1Then do
sudo sysctl -p. - 🚫 "Incorrect password" (although the password is correct):
Check the case of the characters (Linux is case sensitive!) and the network security type. If the router uses
WPA3, try switching toWPA2. - 📡 The network is visible but does not connect.:
The adapter may be operating in mode
monitoror blocked. Check the interface status:rfkill listIf the output contains
Soft blocked: yes, unlock:sudo rfkill unblock wifi
A critical issue for laptops with hybrid graphics (NVIDIA + Intel): some NVIDIA drivers conflict with Wi-Fi modules. If the network connection is lost after installing proprietary video drivers, try rolling back to an open-source driver. nouveau or update the system kernel.
6. Alternative ways to connect to the Internet
If Wi-Fi setup fails, temporarily connect to the Internet using another method to download drivers or update the system:
- 🌐 Ethernet cable: Connect to the router via
LAN-port. In most cases, a wired network works out of the box. - 📱 USB tethering from phone:
Connect your smartphone via USB, enable modem mode in the phone settings and select USB tethering. IN Q4OS The network should be detected automatically.
- 🔄 Bluetooth tethering:
A less stable, but still working option. Make sure the package is installed on your PC.
bluez:sudo apt install bluez
After connecting to the Internet, update the system and drivers:
sudo apt update && sudo apt full-upgrade -y
⚠️ Caution: When using USB modem (3G/4G) may require package installationusb-modeswitchand setupppp-connections. For the modem Huawei I also need a packagehuawei-modem-modeswitch.
7. Optimize Wi-Fi for stable operation
If Wi-Fi connects but is unstable (drops, low speed), try the following settings:
- 📶 Changing the channel on the router:
In the router settings (
192.168.1.1or192.168.0.1) select the channel manually (for example,6or11for 2.4 GHz). Automatic selection often leads to interference. - 🔗 Disabling Wi-Fi power saving:
Some adapters reduce performance to save power. Disable this:
sudo iwconfig wlan0 power offTo make the change permanent, add the command to startup.
- 🔄 Updating the kernel:
Older kernel versions (< 5.10) may not work well with new adapters. Check your current version:
uname -rIf necessary, update the kernel via
aptor install a more recent version from the repositories backports.
To check the speed and stability of the connection, use the utility ping:
ping -c 100 8.8.8.8
If packet loss (>5%) or high rtt (>100 ms), the problem may be in the router or provider.
Frequently Asked Questions (FAQ)
My Wi-Fi adapter isn't detected at all. What should I do?
First, check if the adapter is enabled in BIOS/UEFI. If yes, but in lspci it's not there, maybe it is USB adapter - then use the command lsusb. For some USB adapters (eg. TP-Link) drivers from the repository are required non-free:
sudo apt install firmware-misc-nonfree
If the adapter is still not visible, try connecting it to a different USB port (preferably USB 2.0).
After a system update, my Wi-Fi stopped working. How can I roll back?
If the problem appeared after updating the kernel or drivers, try:
- Boot from the previous kernel version (in the menu GRUB when starting the PC).
- Remove the problematic package (eg.
sudo apt remove linux-image-5.15.0-XX-generic). - Block a specific package from being updated:
sudo apt-mark hold package_name
To roll back drivers, use apt history or check the logs /var/log/apt/history.log.
Is it possible to use Q4OS without NetworkManager?
Yes, but this requires manual configuration. Alternatives:
wicd- lightweight network manager (install viasudo apt install wicd).connman— a minimalistic daemon (suitable for headless systems).- Manual setup via
wpa_supplicant+dhcpcd(for experienced users).
To remove NetworkManager:
sudo apt purge network-manager
But remember: this may disrupt other network functions!
How do I connect to a WPA3-Enterprise Wi-Fi network (e.g. at a university)?
For networks with WPA3-Enterprise or 802.1X:
- Install the package
wpasupplicant(if not installed). - Create a config
/etc/wpa_supplicant.confwith the following content (replace the data):network={ssid="NETWORK_NAME"
key_mgmt=WPA-EAP
eap=PEAP
identity="YOUR_LOGIN"
password="YOUR_PASSWORD"
phase2="auth=MSCHAPV2"
} - Connect:
sudo wpa_supplicant -i wlan0 -c /etc/wpa_supplicant.conf
For eduroam A certificate may be required - download it from your educational institution's website and specify the path in the config (ca_cert="/path/to/certificate.pem").
Why is Wi-Fi slow compared to Windows?
The reasons may be different:
- Drivers: Windows often uses proprietary drivers with optimizations. In Linux, try alternative drivers (for example, for Realtek RTL8821CE there is a driver
rtl8821ce-dkmsfrom GitHub). - Adapter operating mode: Check what mode your adapter is operating in:
iw list | grep -A 10 "Supported interface modes"If not
APorstation, the driver is not working correctly. - Router settings: Turn it off
802.11r(Fast Roaming) and802.11w(PMF) - they may conflict with Linux drivers.
For speed test use iperf3 or speedtest-cli.