bjo101 # 📌 Quick Tutorial: Install RTL8831BU Driver on BigLinux
BigLinux (based on Manjaro/Arch) may encounter issues when compiling the RTL8831BU/AU Wi-Fi driver. Follow these steps to fix it.
—
🔧 Step 1: Install Dependencies
Open a terminal and run:
sudo pacman -S --needed base-devel linux-headers git dkms
—
📥 Step 2: Download & Compile the Driver
Recommended Option (88×2bu - better support)
git clone https://github.com/morrownr/88x2bu.git
cd 88x2bu
make
sudo make install
If You Prefer the Specific Driver (RTL8831BU)
git clone https://github.com/heesn/rtl8831.git
cd rtl8831
# Fix include paths (if needed)
sed -i 's/#include <drv_types.h>/#include "include\/drv_types.h"/' platform/platform_ops.c
make
sudo make install
—
⚙ Step 3: Install with DKMS (Recommended)
Prevents issues after kernel updates:
sudo dkms add .
sudo dkms install 88x2bu/1.0 # or rtl8831/1.0.0 (depends on the driver)
—
🚀 Step 4: Load the Driver & Verify
sudo modprobe 88x2bu # or 88x1bu (depends on the driver)
ip a | grep wl # Check if Wi-Fi appears
—
✅ Alternative Solution (Via AUR - Easier)
If you prefer automatic installation:
yay -S rtl88x2bu-dkms-git # Or use "pamac install" in BigLinux
—
🔴 Possible Issues & Fixes
Error drv_types.h not found?
Manually edit #include paths in the code or use the 88×2bu driver (more reliable).
Wi-Fi not appearing after reboot?
Run again:
sudo modprobe 88x2bu
Or add the module to initramfs:
echo "88x2bu" | sudo tee -a /etc/modules-load.d/88x2bu.conf
sudo mkinitcpio -P
Done! Your Wi-Fi adapter should now work. 🎉
If you still face issues, let me know below!
Thx
Rafael Ruscher
