If a Realtek Wi-Fi card appears in lspci but ZimaOS says “Wi-Fi Hardware: Missing,” the PCIe device is being detected but the usable wireless driver/firmware path is not complete. In the source thread, the title says RTL8821CE, but the actual lspci output identifies an RTL8852BE 802.11ax controller.
That distinction matters because RTL8821CE and RTL8852BE use different upstream Linux drivers. Current ZimaOS compatibility docs still do not list either PCIe card as a verified Wi-Fi option, so do not assume a Linux Mint driver can simply be installed into ZimaOS like a normal Debian package.
Identify the Exact Chip First
lspci -nnk | grep -A3 -Ei 'network|wireless'
dmesg | grep -Ei 'rtw|firmware|wifi|wlan' | tail -100Use the PCI ID and driver line, not only the product label on the card. The source user's hardware enumerated as RTL8852BE even though the thread referred to RTL8821CE.
RTL8852BE Has an Upstream Linux Driver
The current Linux RTL8852BE driver reference shows that RTL8852BE uses the rtw89_8852be module in modern Linux kernels.
RTL8821CE Uses a Different Driver Family
RTL8821CE is handled by the rtw88 family rather than rtw89. Mixing instructions for the two chipsets can lead to the wrong module and firmware troubleshooting path.
Current ZimaOS Compatibility List Does Not Verify These Cards
The current ZimaOS compatible network adapters lists Intel AX210 and several Ethernet adapters, but not RTL8821CE or RTL8852BE PCIe Wi-Fi.
Do Not Install Random DKMS Packages on the Host
ZimaOS is an appliance-style system. A driver package that works on Ubuntu or Linux Mint may depend on headers, DKMS, package-manager state, or writable system paths that ZimaOS does not expose in the same way.
Check Whether the Module Exists
modinfo rtw89_8852be 2>/dev/null
modinfo rtw88_8821ce 2>/dev/nullIf the exact module is missing, report the PCI ID and driver name to IceWhale rather than forcing an unrelated out-of-tree build.
Use a Verified Adapter for a Production Server
If Wi-Fi is required now, use a currently verified adapter such as Intel AX210 rather than depending on an unverified Realtek PCIe card.
The hardware troubleshooting guide helps structure a compatibility report.
Check Firmware Errors Separately from the Driver Module
A module can exist but still fail because the required Realtek firmware blob is missing. In dmesg, distinguish “module not found” from “failed to load firmware” because those require different fixes from IceWhale.
Use the PCI ID in a Driver Request
For the posted RTL8852BE 1T1R card, the PCI ID matters more than the HP spare-part label. Driver requests should include vendor/device IDs so IceWhale can enable the correct kernel option and firmware package.
Prefer Ethernet for an Always-On NAS
Even when Wi-Fi works, wired Ethernet is usually more predictable for a storage server because it avoids roaming, RF interference, and wireless power-management behavior. Use Wi-Fi when cabling is impractical rather than as the default path for heavy NAS traffic.
FAQ
Is the source card really RTL8821CE?
The forum title says RTL8821CE, but the posted lspci output identifies RTL8852BE.
Why does Linux Mint work?
Mint may include the required kernel module and firmware, while the ZimaOS build may not include or enable the same combination.
Can I apt install the Wi-Fi driver?
Do not treat ZimaOS as a normal Ubuntu host. Prefer a verified adapter or request driver integration.
What should I send IceWhale?
Exact PCI ID, lspci -nnk, relevant dmesg output, ZimaOS version, and whether another Linux distribution works.
