Built a new server for unraid this week, and any help with this, would be much appreciated.

The motherboard I chose is an MSI mag x870e tomahawk, which has a RTL8126 5gb ethernet.



I am testing this new server with a fresh install V7.0.1 trial key to make sure there weren't any hardware issues. 
Of course there isn't native drivers in Linux kernel 6.6.78, so I installed the RTL 8126 plugin.
It recognizes the card, but unfortunately will ONLY negotiate to 100MB plugged in to my Ubiquiti US-8-60W gigabit switch.



I have switched ports and switched cables. All cables being Cat6a. I also have my PIKVM connected to the same switch and connects at gigabit speeds. And the switch connects to my US48 Ubiquiti switch at gigabit speeds. So i doubt it's my switch or cabling.



ethtool says the port is CAPABLE of everything up to 5GB.



Curious thing when booting up, is it shows the IPV4 address isn't set, yet I CAN get to the Unraid gui.



I've attached the diagnostics file.

Thank You.

 

testingtower-diagnostics-20250327-2220.zip

Running the command:

 ethtool -l eth0

 

Gives me:

Channel parameters for eth0:
Pre-set maximums:
RX:             4
TX:             2
Other:          n/a
Combined:       n/a
Current hardware settings:
RX:             2
TX:             2
Other:          n/a
Combined:       n/a

 

Tried to change it:

root@Q253D:/etc# ethtool -L eth0 rx 4 tx 2
netlink error: Operation not supported

Also added into /boot/config/modprobe.d the following

options r8125 rx_queues=4 tx_queues=2 aspm=1 eee=0

 

But no effect.

 

Is any way I can change the RX to the maximum value?

On 12/4/2024 at 7:40 PM, borcio02 said:

Hi,

 

Please help me, because I am already tired how to make it work...

 

I have network 2.5 gb/s -> all devices including NAS.

Without this driver my 8125 realtek nic works as 1 gb/s and I have around 130 mb/s download and upload speed.

 

After installing driver and reboot I can see some improvement but only when downloading things from NAS to my PC/Mac. I can see speeds around 200 mb/s (probably due to HDD max speeds).

 

But... when I am trying to copy to NAS I still seeing 130 mb/s max speed... I don't know how to fix this. I have cache with nvme so it should use full 2.5 gb/s speed...

 

What am I doing wrong?

 

I have unraid ver. 7.0.0-rc.1. I don't know if this works fine in ver. 6.12.14 or something, because I bought and install this NIC today at the morning.

 

Help me

 

Regards

What tells lspci about aspm of the card?

try the command and look for your card:
 

Quote

lspci -vv | awk '/ASPM/{print $0}' RS= | grep --color -P '(^[a-z0-9:.]+|ASPM )'

In my case with an I226-V card on an GigaByte H610i Board i had to disable "ASPM PEG" in BIOS to get it stable @ 2,5 GBE.
Also the I226-T1 i cant get stable.

Test you NIC performance with iperf3 (docker) and another pc in the same network.
So you exclude any other possible bottleneck (hdd's, cache, ... othe ASPM related things).

Having issues keep the connection at 2500 after a reboot it’s fine then after a few minutes it’s dropping to 1000 the plugin says it’s installed and I have rebooted I have swapped the Ethernet cable for three different ones all the same result. I am connected to a virgin media 5x 10gig port it was working fine until I updated to 7.1 

tower-diagnostics-20250430-1014 2.zip

 

root@Tower:~# ethtool eth0
Settings for eth0:
        Supported ports: [ TP ]
        Supported link modes:   10baseT/Half 10baseT/Full
                                100baseT/Half 100baseT/Full
                                1000baseT/Full
                                2500baseT/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
        Advertised pause frame use: No
        Advertised auto-negotiation: Yes
        Advertised FEC modes: Not reported
        Link partner advertised link modes:  100baseT/Half 100baseT/Full
                                             1000baseT/Half 1000baseT/Full
        Link partner advertised pause frame use: Symmetric
        Link partner advertised auto-negotiation: Yes
        Link partner advertised FEC modes: Not reported
        Speed: 1000Mb/s
        Duplex: Full
        Auto-negotiation: on
        Port: Twisted Pair
        PHYAD: 0
        Transceiver: internal
        MDI-X: on
        Supports Wake-on: pumbg
        Wake-on: d
        Current message level: 0x00000033 (51)
                               drv probe ifdown ifup
        Link detected: yes
root@Tower:~# 

Edited April 30, 20251 yr by idmanager

I'm not sure who created this driver add-on, and I don't even know if I'm in the right place for this, but I just wanted to say:

 

THANK YOU SO MUCH!!!!!! 

 

I originally bought a Brostrend 5Gbe network card off of Amazon for my windows 11 plex machine. I decided I didn't like windows as a plex server and my buddies and I at work were looking into Unraid, TrueNAS, etc. Decided to go for Unraid for drive flexibility. After getting everything installed, I went to the Brostrend website and they only had Windows drivers. I went to my Amazon order and the page for the NIC even said only for Windows! I was quite sad for a while. I was browsing through the App section of unraid and found an RL8125 driver addon. Kept looking for the RL8126 driver and found it!!! WORKED LIKE A CHARM!!!!

 

Again.................THANK YOUUUUUUUU!!!!!!!!!!!!!!!

so im upgrading my network, and i have my unraid server (yes i need to update it) and it only has an onboard 1G and no slots available, so.... I decided to try a USB Realtek 8157 5GBps NIC in it.

ok, so I loaded up the drivers in the app store and stuck what they said at the bottom of the go file ('ethtool -s eth0 autoneg on advertise 0x180000000002f')
however it is only connecting at 2.5GBps.

I know the switch and the SFP in there will handle 5gig, as i had no problem with my laptop using that same hardware (Arch Linux)

I dont think it's advertising 5GBps as an option to the switch based on the below advertised link modes.) Anyone have any ideas?

ethtool shows this (sorry, formatting is screwed up a bit):
Settings for eth0:
Supported ports: [ MII ]
Supported link modes:   10baseT/Half 10baseT/Full
100baseT/Half 100baseT/Full
1000baseT/Full
2500baseT/Full
5000baseT/Full
Supported pause frame use: No
Supports auto-negotiation: Yes
Supported FEC modes: Not reported
Advertised link modes:  10baseT/Half 10baseT/Full
100baseT/Half 100baseT/Full
1000baseT/Full
2500baseT/Full
Advertised pause frame use: No
Advertised auto-negotiation: Yes
Advertised FEC modes: Not reported
Link partner advertised link modes:  1000baseT/Full
2500baseT/Full
5000baseT/Full
Link partner advertised pause frame use: No
Link partner advertised auto-negotiation: Yes
Link partner advertised FEC modes: Not reported
Speed: 2500Mb/s
Duplex: Full
Auto-negotiation: on
Port: MII
PHYAD: 32
Transceiver: internal
Supports Wake-on: pumbg
Wake-on: d
Current message level: 0x00007fff (32767)
drv probe link timer ifdown ifup rx_err tx_err tx_queued intr tx_done rx_status pktdata hw wol
Link detected: yes

On 3/28/2025 at 12:26 PM, buellmule said:

Built a new server for unraid this week, and any help with this, would be much appreciated.

The motherboard I chose is an MSI mag x870e tomahawk, which has a RTL8126 5gb ethernet.



I am testing this new server with a fresh install V7.0.1 trial key to make sure there weren't any hardware issues. 
Of course there isn't native drivers in Linux kernel 6.6.78, so I installed the RTL 8126 plugin.
It recognizes the card, but unfortunately will ONLY negotiate to 100MB plugged in to my Ubiquiti US-8-60W gigabit switch.



I have switched ports and switched cables. All cables being Cat6a. I also have my PIKVM connected to the same switch and connects at gigabit speeds. And the switch connects to my US48 Ubiquiti switch at gigabit speeds. So i doubt it's my switch or cabling.



ethtool says the port is CAPABLE of everything up to 5GB.



Curious thing when booting up, is it shows the IPV4 address isn't set, yet I CAN get to the Unraid gui.



I've attached the diagnostics file.

Thank You.

 

testingtower-diagnostics-20250327-2220.zip

I also have same problem...

The rtl8126 driver in apps is old version.(Last version is 10.015.00. In apps version is 10.013.00)

I want upgrade driver version but I don't know how can upgrade.

How can upgrade new driver in Github(https://github.com/jinlife/unraid-r8125-r8152-driver)?

same Here, the driver is too old. I need to figure out how to manually install too as the one in the current package would make my unraid box lockup with 30 minutes.

8 hours ago, Abzstrak said:

same Here, the driver is too old. I need to figure out how to manually install too as the one in the current package would make my unraid box lockup with 30 minutes.

based on github it is running 10.015.00?

On 6/1/2025 at 5:26 AM, LeoRX said:

based on github it is running 10.015.00?

maybe im wrong or confused with the version numbers? but Realtek lists 2.20.1 released on May 23 2025.

https://www.realtek.com/Download/List?cate_id=585

yeah looking at the github, the 8152 driver does seem to be 2.20.1

33 minutes ago, Abzstrak said:

maybe im wrong or confused with the version numbers? but Realtek lists 2.20.1 released on May 23 2025.

https://www.realtek.com/Download/List?cate_id=585

That URL link is for RTL815x USB ethernet.

The USB ethernet driver version 2.20.1 is correct.

The PCI-e ethernet driver version is 10.015.00.

Is different version to USB.

Yeah I'm using a USB, i had no other viable options... I wouldnt use realtek otherwise :)

i just went ahead and uninstalled, rebooted, reinstalled, rebooted, set as eth0, rebooted....

iperf is currently showing showing around 4.8GBps in my quick tests to me machine with a 10g fiber intel nic, which sounds good. I think I installed the driver some time ago and didnt manually update (do we need to)? it was probably before updating to unraid 7

anyway, its running at the moment, I'm not trusting it yet to not lock up as before, but maybe it will be fine now, i dont know.

nope, made it alittle over an hour before hard locking the whole system again...

Dropping back to 7.01 fixes my issues so I am not sure it’s the drivers issues

i dunno, i have two onboard intel 1g NICs, I just set them up in LACP again and its stable...I've no issue with this system for years, its an older i9 9900. I wish I had a way to get a faster NIC though, my own real avenue is the usb 3.1 gen2 ports..... oh well.

The USB adapter seems fine on Arch though

Edited June 4, 20251 yr by Abzstrak

Can anybody running 8125 network driver confirm it’s running at 2500 on unraid 7.12. Every time I upgrade it’s stuck at 1000 I have even tried a fresh usb build using the usb creator and still the same issue. Never had an issue before but this is stumping me the driver looks installed and the 8169 blacklisted but the speed is stuck at 1000 downgrade to 7.01 and the speed is 2500. I don’t know what else to check back on 701 at the moment so I get full speed. The only thing I have noticed is the plug in installs the old driver even though it’s new on the GitHub. I have downloaded the GitHub but unsure how makefile works or how to install the driver ? Any help would be great. Or any other info you require I can add, always updated to the latest version but it looks like I am stuck in the past.

UPDATE

been looking around on net this afternoon and found a driver that's working

drop the attached r8125.ko into flash/EFI/boot/extra folder then

edit nano /boot/config/go and add

insmod /boot/extra/r8125.ko

press Ctrl+X, then Y, then Enter to save.

then reboot

update 2

the driver above has failed and the driver from the plug in is not for the correct linux release

r8125.ko

Edited June 6, 20251 yr by idmanager
found a solution to issue

Hello.

Could you update rtl8126 driver version 10.015.00 base on Kernel 6.12.24-Unraid?

I asked to Realtek lost ping problem, they said to me, RTL8126 should be use 10.015.00 driver version.

But in the Github released 10.015.00 version only can use 6.12.30 kernel version.

So please release 10.015.00 version by kernel 6.12.24.

Thanks.

2 hours ago, hilee said:

But in the Github released 10.015.00 version only can use 6.12.30 kernel version.

So please release 10.015.00 version by kernel 6.12.24.

The most recent kernel used by Unraid is 6.12.24. Looks as you'll need to wait until an Unraid release with 6.12.30 or newer.

1 minute ago, ConnerVT said:

The most recent kernel used by Unraid is 6.12.24. Looks as you'll need to wait until an Unraid release with 6.12.30 or newer.

I know. I'm already checked 10.015.00 version support on 6.12.30 kernel on Github.

But I don't understand why cannot support that driver on 6.12.24.

And I don't know the Unraid when do support upgrade kernel.

Actually I hoped in 7.1.4 do support it, but the kernel version still using 6.12.24 in 7.1.4...

The newer kernel may have code which the driver requires which the older kernel does not.

Or maybe the author has not tested the new driver with the older kernels.

Either way, it seems that we will need to wait until Unraid moves to a newer kernel.

On 2/27/2025 at 3:20 AM, Digitalkiller said:

I have this motherboard:  ASUS PRIME Z890M-PLUS WIFI Z890 LGA 1851 mATX motherboard, Intel® Core™ Ultra Series 2 Ready, Advanced AI PC-ready, 10+1+2+1 80A power stages, DDR5, PCIe® 5.0, USB Type-C®, 3x M.2, Wi-Fi 7, 2.5Gb LAN

 

And this processor: Intel Core Ultra 7 265K - Core Ultra 7 (Series 2) Arrow Lake 20-Core (8P+12E), LGA 1851, 125W Desktop Processor - BX80768265K

 

trying to run my fresh flash drive for 7.0.0, because i needed to start completely over from learning everything i have over the last 5 years. 

 

I'll put in new flash drive and it and it will go through its loading up and i noticed as it kinda pauses that Eth0 not found, then eventually gets to the point where i can login, but above that says i have no ipv4 or ipv6 address.

I have tried to put in the plugins manually and the .txz file to manually install package for from what i have been told is r8125 drivers that i need. each time i install package the reboot fails or let it run with .plg file in plugins folder it also fails. Can someone please help with this problem? I have been running Unraid non-stop for all these years with no hiccups. ....Until now.... I have no logs or diagnostics to provide now....and hardware just bought recently.

 

On 3/2/2025 at 3:18 AM, Digitalkiller said:

I solved my problem. Anyone ever run into this issue. message me and I will tell you how to do it extremely easy.

 

how did you solve this? i've same configuration and same problem partially solved with plugin rtl8125 but now i go to 100mb and not to 2.5gb speed

I'll explain my problem better:

A new Unraid 7.1.4 installation

ASUS Prime Z890M-PLUS WiFi with a Realtek RTL8125D LAN chip with a speed of 2.5 Gbps

At first, it didn't recognize the chip, but after reading the topic, I realized I needed to install the drivers on the community application, so I did.

Now the chip is recognized, but I'm getting 100 MB and not 2.5 GB.

I tried to see if I could update the drivers, and I did so via terminal (with the help of a friend), but nope, it's as if they're resetting at every boot.

I tried replacing the drivers in the plugin folder (I noticed it loads those at every boot), but it still doesn't recognize them.

I set the r8125 file as per the forum.

ASPM option = 1

eee_enable option = 0

But every time I set eee=0, it disappears from the configuration.

I don't know what else to do.

driver mountedr: 9.014.01-NAPI-RSS

blacklist r8169

this is my conf by ethtools:

I have no more ideas about it, please help me

On 7/31/2025 at 10:27 AM, Ricyx said:

how did you solve this? i've same configuration and same problem partially solved with plugin rtl8125 but now i go to 100mb and not to 2.5gb speed

I'll explain my problem better:

A new Unraid 7.1.4 installation

ASUS Prime Z890M-PLUS WiFi with a Realtek RTL8125D LAN chip with a speed of 2.5 Gbps

At first, it didn't recognize the chip, but after reading the topic, I realized I needed to install the drivers on the community application, so I did.

Now the chip is recognized, but I'm getting 100 MB and not 2.5 GB.

I tried to see if I could update the drivers, and I did so via terminal (with the help of a friend), but nope, it's as if they're resetting at every boot.

I tried replacing the drivers in the plugin folder (I noticed it loads those at every boot), but it still doesn't recognize them.

I set the r8125 file as per the forum.

ASPM option = 1

eee_enable option = 0

But every time I set eee=0, it disappears from the configuration.

I don't know what else to do.

driver mountedr: 9.014.01-NAPI-RSS

blacklist r8169

this is my conf by ethtools:

I have no more ideas about it, please help me

i've solved too simple... i've change another cable (3rd cable) with support 5gbps and reinstalled the driver with new cable inserted , now i've full speed (modem unfortunately support only 1gbps but go to 2.5gbps)

cheers, i hope to help someone who have same problem to solve it

Edited August 9, 2025Aug 9 by Ricyx

I just would like to post some appreciation for this driver and thank those in this thread for their suggestions. I have a Gigabyte B760M DS3H motherboard with an RTL8125 Ethernet controller. Adding the modprobe.d r8125.conf file with the line "options r8125 aspm=1" has taken me from only reaching C2 to now seeing C10 at times (mostly C8 though) with all of my docker containers running. This is on Unraid 7.2.0-beta2.

This took my typical low load power use (drives spun down, 12 containers running but not doing much) from ~23 W to ~18W.

1 hour ago, olesam said:

I just would like to post some appreciation for this driver and thank those in this thread for their suggestions. I have a Gigabyte B760M DS3H motherboard with an RTL8125 Ethernet controller. Adding the modprobe.d r8125.conf file with the line "options r8125 aspm=1" has taken me from only reaching C2 to now seeing C10 at times (mostly C8 though) with all of my docker containers running. This is on Unraid 7.2.0-beta2.

This took my typical low load power use (drives spun down, 12 containers running but not doing much) from ~23 W to ~18W.

Do you think (or even know?) that this is a benefit of the newest 7.2 beta version? Did you also get C8/C10 states with this driver under 7.1.x version?