RTL8125(B) PCI Drivers
An Unraid plugin for self-hosters with Realtek RTL8125 or RTL8125B 2.5 Gigabit Ethernet PCI Express cards that installs the vendor-supplied out-of-tree r8125…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
20/100 Low
- Maintained
- 26last commit 465 days ago
- Popular
- 61 GitHub stars
- Easy to install
- 251 install platform, install notes
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 5 days ago
- GitHub stars
- 1
- Open issues
- 0
- Last commit
- 2025-08-13
- Latest release
- v9.016.01
- Activity
- stale
Checked today - source: GitHub (RealtekNIC/Realtek-RTL8125-Series-driver)
Resources & Compatibility
Requirements not published yet.
First-install notes
- Reboot required after install A reboot is required after installing the plugin; upgrading to a newer Unraid version may need a second reboot. source
- Verify driver installation After reboot, use lsmod | grep r8125 to confirm the driver module loaded. source
Fetched today - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Do I need to reboot Unraid after installing or updating the RTL8125 (B) PCI Drivers plugin?
Yes, a reboot is required after installing the plugin. Upgrading to a newer Unraid version may also need a second reboot.
How can I tell whether the r8125 driver is loaded?
Check loaded modules with lsmod | grep r8125 and list interfaces with ifconfig -a. An ethX entry indicates the driver is loaded.
Can passing an RTL8125 NIC through to a VM make Unraid inaccessible?
Yes, adding vfio-pci.ids=10ec:8125 can claim the Realtek 8125 NIC. If that card is used for management, the GUI and SSH may become inaccessible through the LAN.
How do I force 2.5G link speed on the RTL8125 with ethtool?
For kernel v4.10 and later, run ethtool -s eth0 autoneg on advertise 0x80000000002f. For kernels before v4.10, use advertise 0x802f.
Answers sourced from ca.unraid.net, github.com, www.reddit.com
Community
- How to build/install Realtek 8125 drivers? : r/openwrt - Reddit (reddit)
- vfio-pci.ids=10ec:8125 LAn Card issue Passthrough OPNsense - Reddit (reddit)
- Realtek RTL8125 Ubuntu 24.04 Ethernet Fix -- r8125 new driver; purge ... (forum)
- Realtek RTL8125 2.5GbE Driver trouble - Linux Mint Forums (forum)
- Realtek NIC RTL8125BG driver issues - Proxmox Support Forum (forum)
- Realtek RTL8125 Ethernet Not Working - Fedora Discussion (forum)
Collected 48 days ago - public community threads