If a Realtek RTL8188CE card is invisible in ZimaOS, first determine whether the PCIe device is detected and whether the kernel includes the rtl8192ce module before attempting to compile an old GitHub driver. The RTL8188CE is supported by the upstream Linux rtl8192ce driver, but that does not prove the module or firmware is included in every ZimaOS build.
The 2025 community thread ended with IceWhale saying it would try to integrate support, not with a user-verified fix. Current ZimaOS compatibility documentation lists tested adapters such as Intel AX210 but does not list RTL8188CE, so this card should still be treated as a compatibility case to verify rather than guaranteed plug-and-play hardware.
Step 1: Check Whether PCIe Detects the Wi-Fi Card
Run:
lspci -nn | grep -i -E 'network|wireless'
If the RTL8188CE does not appear at all, the problem is below NetworkManager. Reseat the card, verify the slot, and test the card in another system if possible.
Step 2: Check the Expected Linux Driver
Upstream Linux identifies rtl8192ce as the PCIe driver for RTL8192CE and RTL8188CE hardware. The Linux wireless driver documentation documents that mapping.
Check whether the ZimaOS kernel has the module:
modinfo rtl8192ce
lsmod | grep rtl8192ce
If modinfo says the module is not found, an old third-party source tree is unlikely to be the cleanest solution on an appliance OS.
Step 3: Inspect Kernel Messages
Run:
dmesg | grep -i -E 'rtl|firmware|wifi|wlan'
This can distinguish “driver missing” from “driver loaded but firmware failed” or “device initialized but NetworkManager did not create a usable interface.”
Step 4: Check Whether NetworkManager Sees Wi-Fi
If the driver loads successfully, inspect:
ip link
nmtui
If a wireless interface exists but no SSIDs appear, the problem has moved from PCIe/driver detection to firmware, regulatory, radio, or NetworkManager behavior.
Why the Old GitHub Driver Is Not the Best First Fix
The source thread linked a community-maintained RTL8188CE driver whose documented kernel support trails modern kernels. The Linux kernel itself already contains RTL8188CE support via rtl8192ce. Replacing in-tree wireless modules with an older out-of-tree build can create version mismatches and may be lost on the next ZimaOS update.
Because ZimaOS uses an appliance-style system, avoid treating it like Ubuntu and running a long package/compile procedure unless IceWhale specifically documents that workflow for your release.
Use a Known-Compatible Adapter When Reliability Matters
The current ZimaOS network adapter list includes Intel AX210 among tested adapters. The separate AX210 Wi-Fi guide provides a supported reference workflow.
If Wi-Fi is essential for a server and the RTL8188CE module is absent from your build, swapping to known-compatible hardware is often safer than maintaining an out-of-tree kernel module.
How to Report the Missing Driver Usefully
Include the ZimaOS version, uname -r, lspci -nn output, modinfo rtl8192ce result, and relevant dmesg lines. This tells support whether the hardware is missing, the module is omitted, or firmware initialization fails.
The ZimaOS troubleshooting guide provides a broader escalation framework.
FAQ
Which Linux driver does RTL8188CE use?
The upstream Linux wireless documentation maps RTL8188CE PCIe devices to the rtl8192ce driver.
Does that mean RTL8188CE is guaranteed to work on ZimaOS?
No. Upstream kernel support does not guarantee that a particular ZimaOS build includes the module, firmware, or a tested integration for that adapter.
Should I compile the GitHub rtl8188ce driver?
Not as the first step. Check the in-kernel module first. An out-of-tree driver can break across kernel updates and is harder to maintain on ZimaOS.
Why is the card missing from nmtui?
If no wireless interface exists, the driver may not have loaded or the device may not be detected. Diagnose PCIe and kernel support before NetworkManager settings.
