Wi-Fi Adapter Not Detected After Install

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

No Wi-Fi networks appear and wireless interface is missing from Network settings.

Environment & Reproduction

Typical on laptops needing proprietary firmware or newly supported chipsets.

Root Cause Analysis

Kernel module not loaded, rfkill enabled, or firmware blob missing from `linux-firmware` packages.

Quick Triage

Verify whether hardware is present to the kernel before editing netplan.

Step-by-Step Diagnosis

Run `lspci -nnk | grep -A3 -i network`, `rfkill list`, and check boot logs with `journalctl -k | grep -i firmware`.

Solution – Primary Fix

Install required firmware via apt, unblock rfkill, and load module with `modprobe`; reboot if module init needs it.

Solution – Alternative Approaches

Use wired connection or USB tethering to fetch firmware, then pin known-good kernel if regression is suspected.

Verification & Acceptance Criteria

Wireless interface appears (`ip link`), scans networks, and obtains DHCP lease successfully.

Rollback Plan

Unload problematic module and revert firmware package changes; boot previous kernel if needed.

Prevention & Hardening

Keep `linux-firmware` updated and validate chipset support before hardware refresh cycles.

Related Errors & Cross-Refs

`firmware: failed to load`, `No Wi-Fi Adapter Found`, and NetworkManager device unavailable states.

Related tutorial: View the step-by-step tutorial for Ubuntu 26.04 LTS.

View all Ubuntu 26.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Ubuntu Wireless documentation and kernel module/firmware references.