Skip to content
View in the app

A better way to browse. Learn more.

Unraid

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

[Plugin] Realtek R8125 R8126 R8168 and R8152\6\7 drivers

Featured Replies

On 1/30/2026 at 9:58 PM, Nemu said:

I finally found a working setup for my R8125. By now, if I enabled ASPM and the gigabit port on my Fritzbox, I always ended up with 30Mbit/s upload speed. If I switched the Fritzbox tob100Mbit Upload was 95 Mbit, so full speed. The issue was ASPM. Now here what I've done.

  1. Go to unraid page "main"

  2. Click on your flash drive "flash"

  3. Scroll down and you see Unraid OS

  4. Add following

    pcie_aspm=force pcie_aspm.policy=powersupersave pcie_port_pm=force

Then open /boot/config/modprobe.d/

( this is on your flash drive) and check if r8125.conf file is available. If not create it.

Paste following:

options r8125 aspm=1

options r8125 eee_enable=0

options r8125 s5wol=0

Now you have ASPM enabled, which allows your server c-states up to C10. BUT you won't get full network speed, as this enables also L1.1 and L1.2, which seem to prevent full speed.

Use this command in shell to get your NIC PCIE Address.

lspci | grep -i ethernet

mine shows 04:00.0.

now you need to create a script e.g. in plugin "user scripts" with the code below. Change the PCIE address to yours.

# Enable only L1, disable L1.1 and L1.2
echo 1 > /sys/bus/pci/devices/0000:04:00.0/link/l1_aspm
echo 0 > /sys/bus/pci/devices/0000:04:00.0/link/l1_1_aspm
echo 0 > /sys/bus/pci/devices/0000:04:00.0/link/l1_2_aspm

run this script on array start.

Restart your server.

I have included this in my powertop autotune script, which I run on array start (Ive attached it). So far, everythings running great. Server reaches c10 with max network speed.

powertop-autotune.txt

Thanks for this guide.

I'll tried all the stuff and got C10 like promised. This was great.

But speed-wise it was nearly the same as with @nassauer . I got 2.5Gbit/s in one direction, but only about 250Mbit/s in the other direction, measured with iperf3. Building back all the stuff, the system went back to 2.5Gbit in both directions, but only C3.

I think for now, i'll stick with C3 and full speed. But anyway: Thanks for your research and effort.

Edited by JayDee73

  • Replies 460
  • Views 175.1k
  • Created
  • Last Reply

Top Posters In This Topic

Most Popular Posts

  • There are many unexplained  stories about Realtek cards and ASPM ... so I made a little investigation:   The kernel in-tree r8169 driver is a generic driver for all Realtek network cards, de

  • Thanks to ich777 and jinlife compiling the r8127 driver is incredibly easy: Just grab jinlife's repo (GitHub link) and compile it in ich777's unraid_kernel docker (GitHub link). Result: https://githu

  • Thanks for the plugins, looks like they are working fine both for the 8152 and 8125.   FYI, if with the 8152 you don't get 2.5GbE advertised link speed try adding to the go file:   e

Posted Images

On 2/6/2026 at 10:39 PM, Free Man said:

It's good to see that this plugin is still alive, functioning and supported!
I've just picked up a new MoBo with a Realtec 8126 5G on board, and it looks like I'll want to install this plugin after getting the new hardware installed.

I might not get a full 5GB/s out of it yet, but, well, I don't have any other devices on the network with > 1GB NICs, so it won't matter much for now, and there's plenty of time for the driver to mature before I'll really need it.

7.3 has drivers built in for 8169.

ethtool eth4

Settings for eth4:

Supported ports: [ TP MII ]

Supported link modes: 10baseT/Half 10baseT/Full

100baseT/Half 100baseT/Full

1000baseT/Full

2500baseT/Full

5000baseT/Full

Supported pause frame use: Symmetric Receive-only

Supports auto-negotiation: Yes

Supported FEC modes: Not reported

Advertised link modes: 10baseT/Half 10baseT/Full

100baseT/Half 100baseT/Full

1000baseT/Full

2500baseT/Full

5000baseT/Full

Advertised pause frame use: Symmetric Receive-only

Advertised auto-negotiation: Yes

Advertised FEC modes: Not reported

Link partner advertised link modes: 10baseT/Half 10baseT/Full

100baseT/Half 100baseT/Full

1000baseT/Full

Link partner advertised pause frame use: No

Link partner advertised auto-negotiation: Yes

Link partner advertised FEC modes: Not reported

Speed: 1000Mb/s

Duplex: Full

Auto-negotiation: on

master-slave cfg: preferred slave

master-slave status: slave

Port: Twisted Pair

PHYAD: 0

Transceiver: internal

MDI-X: Unknown

Supports Wake-on: pumbg

Wake-on: d

Link detected: yes

lspci -ks 83:00.0

83:00.0 Ethernet controller: Realtek Semiconductor Co., Ltd. Killer E5000 5GbE Controller (rev 04)

Subsystem: Micro-Star International Co., Ltd. [MSI] Device 7e17

Kernel driver in use: r8169

Kernel modules: r8169

I have finally gotten to the point where I've got my server back up & running on new hardware. The MoBo has a Realtek 8126 5Gbps NIC, so I'm currently running on a USB NIC to get access, and am trying to install the 8126 version of this plugin, but it's just sitting at the "Install Plugin - In Progress" screen and nothing's happened for a good 10 minutes.
I have full access to the server from my desktop machine. I have full internet access (been chatting on Discord, posting this, wife's surfing...), but nothing is happening here.

I hit the "Close" button and went to look at the installed plugins to see what was up. Turns out it did install, it just didn't report anything.

Additionally, I've got the RTL8168(B)/RTL8111(B) PCI Drivers installed because that's what my old hardware needed. It might be worthwhile during the install to check for other non-built in drivers and remind the user that (s)he may want to uninstall those, as I'm doing next. Now, as I uninstall, I get the same blank "uninstall" screen for a couple of minutes now with nothing happening. I close the dialog, scroll through my plugins and the 8168/8111 driver is gone.

I really appreciate you putting these together. It might be nice if there was some sort of output to let us know that it actually (un)installed.

Edited by Free Man

how do we keep the settings in the motprobe.d folder persistant?

for example those ones:

options r8125 aspm=1

options r8125 eee_enable=0

options r8125 s5wol=0

9 hours ago, ApfelBirneKreis said:

how do we keep the settings in the motprobe.d folder persistant?

for example those ones:

options r8125 aspm=1

options r8125 eee_enable=0

options r8125 s5wol=0

Apparently chatgpt is very helpful with such questions. Could not believe it myself but this really makes it easy for linux starters. (honest reply as a beginner myself)

ChatGPT
No image preview

ChatGPT - Unraid modprobe persistence

ChatGPT hilft dir, Antworten zu finden, Inspiration zu schöpfen und produktiver zu arbeiten.

  • 1 month later...

Do we know if Unraid 7.3 Beta 1/2 added support for the 10G chips (8127 and 8157) ?

3 hours ago, OrdinaryButt said:

Do we know if Unraid 7.3 Beta 1/2 added support for the 10G chips

8127 is supported; I have one.

On 2026/4/13 at PM10点53分, JorgeB said:

8127 支持;我有一个。

On 4/13/2026 at 10:53 PM, JorgeB said:

8127 is supported; I have one.

I also have an 8127 (network card/device), but on Unraid 7.3 Beta 1 and Beta 2, I keep getting the error: "Interface-Ethernet Port 0 is down. Check cable!" It works fine when installing other systems. Do I need to install additional drivers? Thanks.

33f1256fe8dbfc205edb6c55b4edba8d.png

4 hours ago, jyueh said:

I also have an 8127 (network card/device), but on Unraid 7.3 Beta 1 and Beta 2, I keep getting the error: "Interface-Ethernet Port 0 is down. Check cable!" It works fine when installing other systems. Do I need to install additional drivers? Thanks.

Should not need anything else, please start a new topic in the general support forum and post the diagnostics.

Hi,
I (think I) have an R8168 NIC on my Gigabyte X570 UD (V1.0) motherboard.

In Network Settings, I see both eth0 and et1 which have the same MAC address, which seems odd to me. I tried installing the appropriate drivers plugin but then when my server boots up its quite slow and after about 2 minutes after logging into it from a web browser (so while it's still busy starting everything) it becomes unresponsive and then unavailable on the network.

I have temporarily uninstalled this drivers plugin and everything works again (except I still see eth0 and eth1 and WOL is not working). My initial aim was to make WOL usable.

Have I done something wrong?

Thank you in advance.

Edited by CiaoCiao

On 4/13/2026 at 2:53 PM, JorgeB said:

8127 is supported; I have one.

I just got RTL8127 , SFP+ version which is 8127AF chip or something like that. Settings, Network, Interface Rules lists it as "R8169" (confirmed by matching MAC address), but Tools, System Devices, lists "RTL8127 10Gbe Controller (rev08)." What did you do to get yours recognized properly?
7.3.0 rc1. Also going to Tools, System Drivers, if I search for "8127" - no results found. Note - I don't have any custom drivers installed, as I was told 8127 should be supported in kernel on 7.3 (it seems that way).

1 hour ago, OrdinaryButt said:

I just got RTL8127 , SFP+ version which is 8127AF chip or something like that. Settings, Network, Interface Rules lists it as "R8169" (confirmed by matching MAC address), but Tools, System Devices, lists "RTL8127 10Gbe Controller (rev08)." What did you do to get yours recognized properly?

Nothing, it works out of the box, but mine is 8127A, not sure if the AF version is also supported, you can post the diags to take a look, but it's better to do it in a new general support thread, since it's unrelated to the plugin.

11 minutes ago, JorgeB said:

Nothing, it works out of the box, but mine is 8127A, not sure if the AF version is also supported, you can post the diags to take a look, but it's better to do it in a new general support thread, since it's unrelated to the plugin.

I will do that, but does your driver page show package for 8127? Mine doesn't:
image.png

4 minutes ago, OrdinaryButt said:

I will do that, but does your driver page show package for 8127? Mine doesn't:

I'm using the upstream Realtek driver; it's stock with Unraid 7.3

11 minutes ago, JorgeB said:

I'm using the upstream Realtek driver; it's stock with Unraid 7.3

I apologize, I don't know what this is referring to. The screenshot I shared above is from brand new 7.3 rc1 installed this morning on a clean USB drive. Did not install anything custom on this instance. Are you suggesting that the driver your system uses will not show up in the System Drivers list?

Edited by OrdinaryButt

5 minutes ago, OrdinaryButt said:

I apologize, I don't know what this is referring to.

I misread the screenshot, thought it was from the plugin. The stock driver that NIC uses is r8169, not rtl8169

2 minutes ago, JorgeB said:

I misread the screenshot, thought it was from the plugin. The stock driver that NIC uses is r8169, not rtl8169

so r8169 (which is what my adapter shows up as I said in my first comment today) is what is being used for 8127 10g adapters?

7 minutes ago, OrdinaryButt said:

so r8169 (which is what my adapter shows up as I said in my first comment today) is what is being used for 8127 10g adapters?

Correct:

image.png

  • 2 weeks later...
On 8/29/2025 at 5:50 PM, JayDee73 said:

Another question: Did you try any iperf performance tests with this setup? I had the issue that as soon as I added the mentioned conf file, performance dramatically went down from 2.5G to about 250Mbit. At least in one direction and with 7.1 version. After weighing performance and power consumption, I decided to stick with the performance (so no conf file), but with activated powertop which at least brought me to C3 states.

But maybe things have improved with 7.2, which would be great news.

I have the exact same issue, but with an Intel i226-v.
Have to add the following to the /boot/config/go file (also where my other powertop tweaks are):

# disable ASPM for I226-V, when this is enabled the network speed drops often to <300 MB/s (instead of full performance of 2500 MB/s)
# with this workaround the system can reach c-state c3 (~15,8 Watt) and have full ethernet performance
echo 0 > /sys/bus/pci/devices/0000:01:00.0/link/l1_aspm

to get it stable at 2,5 GBE, sure not reaching lower c states than C3. Where ASPM is enabled for the card my system reaches C6, but with the exact same performance drop to about 250-300 Mbit/s (tested with iperf3).

First few tests it reaches 2,5 GBE, but after a short idle time it has that drop issue

Also tested a few years back an i226-T1 geniue Intel card and an rtl8125b which has exactly the issue. Sure my Mobo bios (Gigabyte H610i) is up to date

So I will not test an rtl8125b card again, because than I have to also deal with drivers on every unRAID upgrade.

Also updated my NVM flash of my Intel card (there is an open sense forum thread for that) without success.

I am on newest unRAID 7.3.0-rc1 now, because of internal boot, which is on 6.18.23 now. Maybe test aspm again, but my hopes are low after all this year's without an working 2,5 GBE nic + proper ASPM support.

Hope this will ever be fixed.

pOpY

Edited by pOpYRaid

Just a quick update:
i enabled aspm for the i226-v (commenting out the code from my previous post in /boot/config/go) on newest unRAID 7.3.0-rc1 (which is on kernel 6.18.23).
Confirming aspm enabled/disabled state with lspci (before and after) -> it was disabled before and is now enabled for the card.
After spinning down all hdds and let it idling i am reaching C6 now and the network speed has not dropped on 10x iperf tests.

Will test further and hoping the aspm issue is gone.
If not will test also the suggestion of disabling just L1.1 L_1.2: https://forums.unraid.net/topic/141349-plugin-realtek-r8125-r8126-r8168-and-r815267-drivers/page/17/#findComment-1605492

Edited by pOpYRaid

Finally!!!!!!!!!!!!!!!!!!!!!!!!!!!!

The i226-v driver bug i am reffering to in my last posts (performance loss when ASPM is on) is fixed in unraid 7.3.0-rc1 (kernel 6.18.23).
Here is the commit which fixed the issue: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=0325143b59c6c6d79987afc57d2456e7a20d13b7

Basically disabling aspm L1.2, preventing the performance issue with minimal higher power consumption.

So with this commit i can recommend the Intel i226-v for low power unraid builds and have ASPM with no performance loss working.
The c-states rabbit hole has become smaller for me 😁

Sorry for hijacking this realtek thread, but in the search if there is an working alternative google has guided me here.
Hope this helps somebody to escape the c-states rabbit hole.

Edited by pOpYRaid

On 5/3/2026 at 4:05 PM, pOpYRaid said:

Finally!!!!!!!!!!!!!!!!!!!!!!!!!!!!

The i226-v driver bug i am reffering to in my last posts (performance loss when ASPM is on) is fixed in unraid 7.3.0-rc1 (kernel 6.18.23).
Here is the commit which fixed the issue: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=0325143b59c6c6d79987afc57d2456e7a20d13b7

Basically disabling aspm L1.2, preventing the performance issue with minimal higher power consumption.

So with this commit i can recommend the Intel i226-v for low power unraid builds and have ASPM with no performance loss working.
The c-states rabbit hole has become smaller for me 😁

Sorry for hijacking this realtek thread, but in the search if there is an working alternative google has guided me here.
Hope this helps somebody to escape the c-states rabbit hole.

Is this fixing all hardware revisions of this chip? I remember something about first gen bundled with Intel 400 series motherboards has issues and that the 500 series motherboard supposedly had a hardware revision update that solve that.

Do any of these plugins support RTL8127? The r8169 kernel driver in Unraid 7.3 has an issue with SFP+ version of this card (erroneously says cable unplugged); After testing multiple Ubuntu kernels, it is only in Kernel 7.0 that the upstream driver was resolved.

On 1/14/2026 at 11:50 PM, vesqute said:

Thanks to ich777 and jinlife compiling the r8127 driver is incredibly easy:

Just grab jinlife's repo (GitHub link) and compile it in ich777's unraid_kernel docker (GitHub link).

Result: https://github.com/vesqute/unraid-r8125-r8152-driver

The unraid-r8127.plg installed fine for me and the card works, though I haven't done any further tests yet.

To activate ASPM, add this as Modprobe config to the driver under Tools -> System Drivers:

options r8127 aspm=1

Result in AutoTweak:

image.png

How exactly does one install the 8127 driver? Please explained for someone that has never done custom driver install outside of the Unraid app store. Thanks.

15 hours ago, OrdinaryButt said:

Is this fixing all hardware revisions of this chip? I remember something about first gen bundled with Intel 400 series motherboards has issues and that the 500 series motherboard supposedly had a hardware revision update that solve that.


It seems the commit does not differentiate between hardware, but thats my assumption.
Take it with a grain of salt.

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.