Scale driver for RTL8126

TrueNAS General
1

Just got my 5Gbe Ethernet card that uses the rtl8126 chipset. It shows up when doing lspci but no driver loaded. Anyone know if it’s coming in later versions of Truenas Scale?

2

Did you manage to get it working?

3

Unfortunately no. The driver is included in later versions of the kernel, so here’s hoping it’s included in the next release.

4

25.04 is expected to ship a newer LTS kernel (probably 6.12?). BETA for that in Feb~ timeframe.

1 Like
5

I got this working. It took me a few hours, but I did it. Still working out the kinks, iperf3 has me at 3.32gb transfer speeds. Pretty sure its my cable or my SFP adapter, I will do more testing.

enable developer mode:
sudo /usr/local/libexec/disable-rootfs-protection
(You cant undo this)

unmount/remount:
mount -o remount,rw ‘boot-pool/ROOT/24.04.0/usr’
(Make sure you use the version you have installed, I had to use 24.04.2.2)

Then you do this:
export PATH=/usr/bin:/usr/sbin

And then you do this:
chmod +x /bin/apt*
chmod +x /usr/bin/dpkg

Then you download the realtek driver (Realtek’s website has a dumb download, I downloaded the file, uploaded it to a free filehost, then used wget to download it to my TrueNAS install)

Then I unpacked the tar.bz2 file

Then I ran the autorun.sh with Bash
bash -x ./autorun.sh

Rebooted, and it worked fine.

Hope this helps. I literally created an account on the forum to share this.
~RT

2 Likes
6

Thanks for posting a solution.

I tried but when i run the autorun.sh it start but the system crashes. It displays this before the crash:

root@truenas[~/r8126-10.013.00]# bash -x ./autorun.sh
+++ uname -r
++ find /lib/modules/6.6.32-production+truenas/kernel/drivers/net/ethernet -name realtek -type d

  • TARGET_PATH=/lib/modules/6.6.32-production+truenas/kernel/drivers/net/ethernet/realtek

  • ‘[’ /lib/modules/6.6.32-production+truenas/kernel/drivers/net/ethernet/realtek = ‘’ ‘]’

  • ‘[’ /lib/modules/6.6.32-production+truenas/kernel/drivers/net/ethernet/realtek = ‘’ ‘]’

  • echo

  • echo ‘Check old driver and unload it.’
    Check old driver and unload it.
    ++ lsmod
    ++ grep r8169

  • check=‘r8169 114688 0
    mdio_devres 12288 1 r8169
    libphy 241664 3 r8169,mdio_devres,realtek’

  • ‘[’ ‘r8169 114688 0
    mdio_devres 12288 1 r8169
    libphy 241664 3 r8169,mdio_devres,realtek’ ‘!=’ ‘’ ‘]’

  • echo ‘rmmod r8169’
    rmmod r8169

  • /sbin/rmmod r8169

P.S. im on 24.04.2.2

7

Any luck yet? Just purchased a pair of these NIC’s and didn’t even think it might not be supported.

8

Have anyone had any success with RTO8126 on Fangtooth 25.04 RC?

9

It works! Just upgraded to Fangtooth RC and the card works perfectly!

iperf3

[ ID] Interval Transfer Bitrate
[ 5] 0.00-8.00 sec 4.56 GBytes 4.89 Gbits/sec

1 Like
10

Can you tell what exactly you did. Unfortunately see that the network card works. But unfortunately as if the motherboard doesn’t see it or the system as in your case.

11

Which card are you on now, I moved to TrueNAS SCALE Fangtooth 25.04 [release] and still cant seem to get it to work.

System details:

  • TrueNAS SCALE 25.04 Fangtooth (Linux kernel 6.12.15)
  • MSI B550M PRO-VDH WIFI motherboard
  • BrosTrend 5GbE PCIe Network Card (RTL8126 chipset)

Current Status:

The network card is detected by the system:

lspci -v | grep -I eth
05:00.0 Ethernet controller: Realtek Semiconductor Co., Ltd. Device 8126 (rev 01)

But the r8169 driver is loaded instead of a proper RTL8126 driver:

lsmod | grep r8169
r8169                 118784  0
mdio_devres            12288  1 r8169
libphy                229376  3 r8169,mdio_devres,realtek

The interface shows up and I can get 1Gb but not 5Gb?

12

The BrosTrend 5Gb card worked fine for me with a fresh 25.04 install, no issues.