Problem with RTL8126 NIC / Driver; don't know how to get it working

hi, i have a nuc with Realtek 8126 5Gb. i'm running proxmox 8.3

I'm trying everything to make it work to no avail

I'm following this guide

https://github.com/awesometic/realtek-r8126-dkms

when i lunch command "sudo dpkg -i realtek-r8126-dkms_10.014.01-1_amd64.deb"

I get this

Code:
Preparing to unpack realtek-r8126-dkms_10.014.01-1_amd64.deb ...
Deleting module realtek-r8126-10.014.01 completely from the DKMS tree.
Unpacking realtek-r8126-dkms (10.014.01-1) over (10.014.01-1) ...
Setting up realtek-r8126-dkms (10.014.01-1) ...
Loading new realtek-r8126-10.014.01 DKMS files...
Building for 6.11.0-2-pve
Building for architecture amd64
Module build for kernel 6.11.0-2-pve was skipped since the
kernel headers for this kernel do not seem to be installed.

i'm triyng last kernel 6.11.0-2-pve with last kernel-headers

could someone help me?

many thanks
 
hi, i have a nuc with Realtek 8126 5Gb. i'm running proxmox 8.3

I'm trying everything to make it work to no avail

I'm following this guide

https://github.com/awesometic/realtek-r8126-dkms

when i lunch command "sudo dpkg -i realtek-r8126-dkms_10.014.01-1_amd64.deb"

I get this

Code:
Preparing to unpack realtek-r8126-dkms_10.014.01-1_amd64.deb ...
Deleting module realtek-r8126-10.014.01 completely from the DKMS tree.
Unpacking realtek-r8126-dkms (10.014.01-1) over (10.014.01-1) ...
Setting up realtek-r8126-dkms (10.014.01-1) ...
Loading new realtek-r8126-10.014.01 DKMS files...
Building for 6.11.0-2-pve
Building for architecture amd64
Module build for kernel 6.11.0-2-pve was skipped since the
kernel headers for this kernel do not seem to be installed.

i'm triyng last kernel 6.11.0-2-pve with last kernel-headers

could someone help me?

many thanks
The Kernel headers are not installed. Install them with apt install proxmox-headers-6.11
 
  • Like
Reactions: justinclift
SOLVED!! (tested with kernel 6.8.12-6)

I have ATOMMAN X7 Ti with 2x 5gb Realtek 8126 card

procedure step by step:

1) wget https://github.com/awesometic/realt...01-1/realtek-r8126-dkms_10.014.01-1_amd64.deb

2) apt install sudo

3) sudo apt install --fix-broken

4) sudo apt-get install build-essential

5) sudo apt-get update

6) sudo apt-get install dkms

7) apt install proxmox-headers-6.8.12-6-pve

8) sudo dpkg -i realtek-r8126-dkms_10.014.01-1_amd64.deb

Screenshot 2025-01-16 134204.png

9) echo "blacklist r8169" | sudo tee /etc/modprobe.d/blacklist-r8169.conf

10) sudo update-initramfs-u

11) type "dkms status" for check if the driver 8126 has been installed correctly

Screenshot 2025-01-16 220431.png

12) apt install net-tools and type ifconfig -a for check that the network cards are correctly recognized

Screenshot 2025-01-16 145503.png

13) type "lspci" on shell for for check that the network cards are correctly recognized and driver 8126 has been installed correctly

14) go to proxmox -> network -> vmbr0 and add the name of the two network cards to "bridge ports" section (they should be enp86s0 e enp87s0)

Screenshot 2025-01-16 213713.png

Screenshot 2025-01-16 213833.png

15) apply configuration in the tab and reboot

HAVE FUN :)


IMPORTANT !! remember that if you update the kernel you will also have to update proxmox-headers-6.8.xx-x-pve

5gbe.jpg
 

Attachments

  • Screenshot 2025-01-16 213713.png
    Screenshot 2025-01-16 213713.png
    21 KB · Views: 12
Last edited:
SOLVED!! (tested with kernel 6.8.12-6)

I have ATOMMAN X7 Ti with 2x 5gb Realtek 8126 card

procedure step by step:

1) wget https://github.com/awesometic/realt...01-1/realtek-r8126-dkms_10.014.01-1_amd64.deb

2) apt install sudo

3) sudo apt install --fix-broken

4) sudo apt-get install build-essential

5) sudo apt-get update

6) sudo apt-get install dkms

7) apt install proxmox-headers-6.8.12-6-pve

8) sudo dpkg -i realtek-r8126-dkms_10.014.01-1_amd64.deb

View attachment 80879

9) echo "blacklist r8169" | sudo tee /etc/modprobe.d/blacklist-r8169.conf

10) sudo update-initramfs-u

11) type "dkms status" for check if the driver 8126 has been installed correctly

View attachment 80878

12) apt install net-tools and type ifconfig -a for check that the network cards are correctly recognized

View attachment 80880

13) type "lspci" on shell for for check that the network cards are correctly recognized and driver 8126 has been installed correctly

14) go to proxmox -> network -> vmbr0 and add the name of the two network cards to "bridge ports" section (they should be enp86s0 e enp87s0)

View attachment 80882

View attachment 80883

15) apply configuration in the tab and reboot

HAVE FUN :)


IMPORTANT !! remember that if you update the kernel you will also have to update proxmox-headers-6.8.xx-x-pve

View attachment 80877
Thanks mate you solved my issue.

This line was not needed for me: sudo update-initramfs-u

As you mentioned I had to use: apt install proxmox-headers-6.8.12-8-pve
 
Last edited:
I seem to still have an issue with this nic even though it works. Testing from the proxmox host with RTL8126 with iperf3 to my nas and windows machine i get a solid 4.7Gbits in one direction and between 400-500Mbits in the other direction. Anyone have a clue? It seems to have single RX/TX queue, incomplete RSS support