Connecting Kali Linux to Wi-Fi: A Complete Guide with Error Fixes

Kali Linux — is a powerful security testing tool, but its configuration often raises questions for beginners. One of the first barriers is connecting to a wireless network. Unlike Windows or macOSThere's no traditional "click and connect" here. You need to configure the system manually, and sometimes even compile drivers.

In this article we will look at all the current connection methods. Kali Linux to Wi-Fi: from standard utilities nmcli And nmtui before manual tuning through wpa_supplicantLet's take a closer look at typical mistakes (for example, "Device not ready" or "Authentication failed") and how to fix them. If your adapter isn't detected by the system, you'll find a solution here.

1. Hardware Check: Does Kali Linux Detect Your Wi-Fi Adapter?

Before attempting to connect to the network, make sure the system "sees" your wireless adapter. Many connection issues are caused by missing drivers or incorrectly functioning hardware.

Run the following command in the terminal:

iwconfig

In the output, look for a section with the name wlan0, wlp3s0 or something similar (depending on the adapter model). If such a section is missing, the adapter was not detected. There may be various reasons:

  • 🔌 The adapter is physically disconnected (check the switch on the laptop or the USB port)
  • 🚫 Drivers are missing (especially relevant for adapters) Realtek, Broadcom or new models Intel AX200/AX210)
  • 🔄 The adapter is blocked by the system (check the output rfkill list)

If the adapter is detected but does not work, try enabling it with the command:

sudo ip link set wlan0 up

Replace wlan0 to the current name of your interface from the output iwconfig.

📊 What type of Wi-Fi adapter are you using in Kali Linux?
Built into the laptop
USB adapter
PCIe card
Don't know

2. Connecting via the graphical interface (NetworkManager)

The easiest way is to use the built-in NetworkManagerIt is available in most builds. Kali Linux (except for the minimum version) Kali Linux Light).

Instructions:

  1. Click on the network icon in the upper right corner (next to the clock).
  2. Select the desired network from the list.
  3. Enter your password and click Connect.

If there is no network icon or the list is empty:

  • 🔄 Restart the service: sudo systemctl restart NetworkManager
  • 🔧 Check if Wi-Fi is turned on: nmcli radio wifi (should be enabled)
  • 📡 Update the list of networks: nmcli device wifi rescan

For hidden networks (hidden SSID) use the command:

nmcli device wifi connect "NETWORK_NAME" password "PASSWORD" hidden yes

3. Connecting via terminal: nmcli and nmtui

If the graphical interface is not available or does not work, use utilities nmcli (command line) or nmtui (text interface).

Method 1: nmcli (recommended for automation)

View the list of available networks:

nmcli device wifi list

Connect to the network:

nmcli device wifi connect "NETWORK_NAME" password "PASSWORD"

For the network with WPA2-Enterprise (corporate authentication) use:

nmcli connection add type wifi con-name "WorkNetwork" ifname wlan0 ssid "NETWORK_NAME" wifi-sec.key-mgmt wpa-eap

nmcli connection modify "Work Network" wifi-sec.eap peap

nmcli connection modify "Work Network" wifi-sec.identity "LOGIN"

nmcli connection modify "WorkNetwork" wifi-sec.password "PASSWORD"

nmcli connection up "Work Network"

Method 2: nmtui (beginner-friendly)

Launch the text interface:

sudo nmtui

Select Activate a connection → find your network → enter the password.

The adapter is turned on (ip link show wlan0 shows UP)

The NetworkManager service is active (systemctl status NetworkManager)

Wi-Fi is not blocked (rfkill list shows Soft blocked: no)

The network is visible in nmcli device wifi list-->

4. Manual connection via wpa_supplicant (if NetworkManager does not work)

If NetworkManager is disabled or conflicts with other services, use wpa_supplicant — a standard utility for managing Wi-Fi in Linux.

Steps:

  1. Disable NetworkManager (if it interferes):
    sudo systemctl stop NetworkManager
  2. Generate a network config:
    wpa_passphrase "NETWORK_NAME" "PASSWORD" | sudo tee /etc/wpa_supplicant.conf
  3. Connect to the network:
    sudo wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant.conf
  4. Get an IP address:
    sudo dhclient wlan0

For hidden networks, add in /etc/wpa_supplicant.conf line:

scan_ssid=1

Check your connection:

ping -c 3 8.8.8.8
What to do if wpa_supplicant returns the error "CTRL-EVENT-SSID-TEMP-DISABLED"

This error means authentication failed. Reasons:

- Incorrect password (check the case!)

- Unsupported encryption type (e.g. WPA3 on older adapters)

- MAC filtering on the router (add your adapter's MAC to the whitelist)

- Wi-Fi channel higher than 14 (in some countries manual configuration of the regulatory domain is required)

5. Troubleshooting Wi-Fi adapter drivers

More than 40% of Kali Linux Wi-Fi connection issues are due to missing or incorrectly working drivers.This is especially true for adapters. Realtek RTL88xx And Broadcom.

Check your current driver:

lspci -k | grep -A 3 -i network
Adapter chipset Required driver Installation command
Intel AX200/AX210 iwlwifi (part of the core) sudo apt update && sudo apt install firmware-iwlwifi
Realtek RTL8821CE rtl8821ce sudo apt install realtek-rtl8821ce-dkms
Broadcom BCM43xx bcmwl-kernel-source sudo apt install broadcom-sta-dkms
Mediatek MT7921 mt7921e (core 5.12+) sudo apt install firmware-misc-nonfree

If your adapter is not listed:

  1. Check support on the manufacturer's website.
  2. Install the latest kernel version:
    sudo apt update && sudo apt full-upgrade -y
  3. For new adapters (eg. Intel BE200) manual compilation of the driver may be required official repository.

6. Diagnosing and troubleshooting connection errors

Let's look at the most common errors and their solutions:

Error: "Device not ready" (wlan0)

Reasons:

  • 🔌 The adapter is disabled physically or software-wise.
  • 🚫 Driver missing.
  • 🔄 Conflict with other services (eg. wpasupplicant And NetworkManager work simultaneously).

Solution:

sudo rfkill unblock wifi

sudo ip link set wlan0 up

sudo systemctl restart NetworkManager

Error: "Authentication failed" or "Incorrect password"

Most often, this is not a password error, but a problem with:

  • 🔒 The type of encryption (for example, the router uses WPA3, and the adapter only supports WPA2).
  • 📡 Wi-Fi channel (channels 12-14 may require manual region setting).
  • ⏳ DHCP timeout (try static IP).

Check supported encryption types:

iw list | grep -A 10 "Supported interface modes"

Error: "No route to host" after connecting

The network is connected, but the internet is not working. Check:

ip route show

If there is no default route, add one:

sudo ip route add default via 192.168.1.1

Replace 192.168.1.1 to your router's IP.

7. Connecting to Wi-Fi without a password (open networks)

To connect to an open network (without a password) in Kali Linux use:

nmcli device wifi connect "NETWORK_NAME"

If the network requires authorization through a web portal (for example, in hotels or airports):

  1. Connect to the network (even without the Internet).
  2. Open your browser and go to any website (for example, http://neverssl.com).
  3. You should be redirected to the login page.
  4. Enter your login/password (if required) or accept the terms of use.

To automate the process you can use curl:

curl -v http://neverssl.com

Look for the line in the output Location: — this is the address of the authorization page.

8. Alternative methods: USB tethering and external adapters

If the built-in Wi-Fi adapter does not work, consider alternatives:

Method 1: USB tethering with Android

Connect your phone via USB and enable modem mode:

  1. On the phone: Settings → Network & Internet → Hotspot & Tethering → USB Tethering.
  2. In Kali Linux, test the new connection:
    ip a (look for the interface usb0 or eth1).
  3. Get IP via DHCP:
    sudo dhclient usb0

Method 2: External Wi-Fi adapter

Recommended models for Kali Linux:

  • 📡 Alfa AWUS036ACH (supports monitor mode, chipset RTL8812AU)
  • 🔗 TP-Link TL-WN722N (chipset AR9271, works out of the box)
  • 💻 Panda PAU09 (dual band, chipset RTL8811AU)

Please check adapter support before purchasing. official Kali Linux website.

How to check Wi-Fi speed in Kali Linux

Install iperf3 on Kali and another computer on the network:

sudo apt install iperf3

On the server (another PC), run:

iperf3 -s

On Kali Linux (client):

iperf3 -c 192.168.1.100

Replace 192.168.1.100 to the server IP.

FAQ: Frequently Asked Questions about Connecting Kali Linux to Wi-Fi

Why can't Kali Linux see my Wi-Fi network, even though other devices can?

Possible reasons:

  • The adapter does not support 5 GHz (try switching your router to 2.4 GHz).
  • The network uses 802.11ax (Wi-Fi 6), and the adapter driver is out of date.
  • In Kali Linux it is disabled regulatory domain (corrected by the command sudo iw reg set RU, Where RU — your country code).
  • Your adapter's MAC address is blocked on the router.

Check available networks with the command:

sudo iwlist wlan0 scanning | grep ESSID
How to connect to Wi-Fi with WPA3 in Kali Linux?

WPA3 is supported in Kali Linux since the kernel 5.4+If the connection does not work:

  1. Update the system:
    sudo apt update && sudo apt full-upgrade -y
  2. Make sure your adapter supports WPA3 (iw list | grep "WPA3").
  3. Use wpa_supplicant with an explicit indication of the security type:
    wpa_supplicant -i wlan0 -c /etc/wpa_supplicant-wpa3.conf

    Specify in the config:

    network={

    ssid="NETWORK_NAME"

    key_mgmt=SAE

    psk="PASSWORD"

    }

Is it possible to connect Kali Linux to Wi-Fi without NetworkManager?

Yes, there are several alternatives:

  1. wpa_supplicant + dhclient (described in section 4).
  2. wicd — lightweight network manager:
    sudo apt install wicd

    Launch: sudo wicd-client

  3. connman (for minimal systems):
    sudo apt install connman

    Control: connmanctl

To completely remove NetworkManager:

sudo apt purge network-manager -y

sudo systemctl enable wpa_supplicant

How to save Wi-Fi settings after rebooting Kali Linux?

If the network is "forgotten", check:

  • Auto-connection enabled:
    nmcli connection show "NETWORK_NAME" | grep autoconnect

    If no, turn on: nmcli connection modify "NETWORK_NAME" connection.autoconnect yes

  • The NetworkManager service starts automatically:
    sudo systemctl enable NetworkManager
  • For wpa_supplicant add in /etc/wpa_supplicant.conf line:
    update_config=1
Why did Wi-Fi stop working after updating Kali Linux?

Most often this is associated with:

  • Updating the kernel (old drivers stopped working).
  • Package conflicts (e.g., simultaneously installed bcmwl-kernel-source And firmware-b43-installer).
  • Configuration changes NetworkManager.

Solutions:

  1. Reinstall the adapter driver (see section 5).
  2. Roll back the kernel to the previous version:
    sudo apt install linux-image-5.18.0-kali5-amd64

    (replace the version with the one that worked)

  3. Check the logs:
    journalctl -u NetworkManager --no-pager -n 50
⚠️ Note: After major Kali Linux updates (for example, from version 2023.4 to 2026.1), you may need to completely reinstall your Wi-Fi drivers. Before updating, back up your configuration files (/etc/NetworkManager/).