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…

  • Drivers
  • Plugins
  • Productivity
  • Tools & Utilities
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 driver when the built-in kernel driver lacks support.

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

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

Collected 48 days ago - public community threads