<!-- mobian-agent-page publisher="dailydev" canonical="https://daily.dev/posts/fixing-my-usb3-2-5gbe-network-adapters-on-linux-proxmox--sxlgodstb" -->

---
title: FIXING my USB3 2.5Gbe network adapters on Linux / Proxmox!
description: Realtek USB 2.5GbE network adapters (RTL8156 and similar) often fail to load the correct kernel driver on Linux and Proxmox due to missing udev rules. The fix...
canonical: https://daily.dev/posts/fixing-my-usb3-2-5gbe-network-adapters-on-linux-proxmox--sxlgodstb
twitter:card: summary_large_image
twitter:site: @dailydotdev
og:type: website
og:site_name: daily.dev
og:title: FIXING my USB3 2.5Gbe network adapters on Linux / Proxmox! | daily.dev
og:description: Realtek USB 2.5GbE network adapters (RTL8156 and similar) often fail to load the correct kernel driver on Linux and Proxmox due to missing udev rules. The fix...
og:url: https://daily.dev/posts/fixing-my-usb3-2-5gbe-network-adapters-on-linux-proxmox--sxlgodstb
og:image: https://api.daily.dev/og/posts/SxlgODsTB.png
og:image:alt: FIXING my USB3 2.5Gbe network adapters on Linux / Proxmox!
og:image:width: 1200
og:image:height: 630
og:locale: en
---

> ## Documentation Index
> Fetch the complete documentation index at: https://daily.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# FIXING my USB3 2.5Gbe network adapters on Linux / Proxmox!

**[apalrd's adventures](https://daily.dev/sources/apalrd)** · 1 min read · 0 upvotes · 0 comments

## Summary

Realtek USB 2.5GbE network adapters (RTL8156 and similar) often fail to load the correct kernel driver on Linux and Proxmox due to missing udev rules. The fix involves creating a udev rules file that sets the correct USB configuration value for the adapter, forcing it to use the proper Realtek driver. This results in dramatically improved bandwidth — approximately 1.5 Gbps full duplex and 1.9 Gbps half duplex. The post provides a ready-to-use udev rules file covering adapters from Realtek, Samsung, Lenovo, TP-Link, Nvidia, and Linksys, applicable to any Debian-based system including Proxmox.

## Full article

daily.dev links to this article rather than hosting it. Read it at the original source: <https://www.apalrd.net/posts/2023/network_realtek8156>

## Questions this post answers

### How do I fix my Realtek USB 2.5GbE adapter not working properly on Linux or Proxmox?

Create a udev rules file that sets the correct USB bConfigurationValue for the Realtek adapter. The rule targets vendor ID 0bda and product IDs 8152, 8153, 8155, 8156, forcing the device into the correct configuration mode (MODE1=1 for most adapters). After adding the file and rebooting, the proper kernel driver loads, yielding roughly 1.5 Gbps full duplex and 1.9 Gbps half duplex throughput.

_Developers and homelabbers troubleshooting Linux networking hardware find fixes like this on daily.dev._

## Similar posts on daily.dev

- [Linux 7.2 To Support Realtek RTL8159 10GbE USB Ethernet](https://daily.dev/posts/linux-7-2-to-support-realtek-rtl8159-10gbe-usb-ethernet-wmjs33e8n) · Phoronix · 0 upvotes · 0 comments
- [Framework's 10G Ethernet module exposes USB-C's complexity](https://daily.dev/posts/framework-s-10g-ethernet-module-exposes-usb-c-s-complexity-ip92umde8) · Jeff Geerling · 2 upvotes · 1 comments
- [Screw you Realtek](https://daily.dev/posts/screw-you-realtek-sfcz4wjay) · Lobsters · 13 upvotes · 1 comments
- [Linux 7.4 To Support Realtek RTL8127atf & RTL8116af Networking](https://daily.dev/posts/linux-7-4-to-support-realtek-rtl8127atf-rtl8116af-networking-jkjr3gyhu) · Phoronix · 0 upvotes · 0 comments
- [New 10 GbE USB adapters are cooler, smaller, cheaper](https://daily.dev/posts/new-10-gbe-usb-adapters-are-cooler-smaller-cheaper-9q5yp1afn) · Jeff Geerling · 0 upvotes · 0 comments

---

Tags: [#linux](https://daily.dev/tags/linux), [#networking](https://daily.dev/tags/networking), [#proxmox](https://daily.dev/tags/proxmox)

[View this post on daily.dev](https://daily.dev/posts/fixing-my-usb3-2-5gbe-network-adapters-on-linux-proxmox--sxlgodstb)

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]}
{"@context":"https://schema.org","@type":"TechArticle","headline":"FIXING my USB3 2.5Gbe network adapters on Linux / Proxmox!","url":"https://daily.dev/posts/fixing-my-usb3-2-5gbe-network-adapters-on-linux-proxmox--sxlgodstb","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/fixing-my-usb3-2-5gbe-network-adapters-on-linux-proxmox--sxlgodstb"},"datePublished":"2026-08-11T08:56:49.621Z","dateModified":"2026-08-11T09:39:12.298Z","description":"Realtek USB 2.5GbE network adapters (RTL8156 and similar) often fail to load the correct kernel driver on Linux and Proxmox due to missing udev rules. The fix...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/ad7149b08dc484ced587a2592d94083d?_a=AQAEuop","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/ad7149b08dc484ced587a2592d94083d?_a=AQAEuop","isAccessibleForFree":true,"articleSection":"apalrd's adventures","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"apalrd's adventures","logo":"https://media.daily.dev/image/upload/s--4zkx8dRj--/f_auto,q_auto/v1786438309/logos/apalrd?_a=BAMAMicg0","url":"https://daily.dev/sources/apalrd"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/fixing-my-usb3-2-5gbe-network-adapters-on-linux-proxmox--sxlgodstb","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"linux,networking,proxmox","timeRequired":"PT1M"}
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"apalrd's adventures","item":"https://daily.dev/sources/apalrd"},{"@type":"ListItem","position":3,"name":"FIXING my USB3 2.5Gbe network adapters on Linux / Proxmox!"}]}
{"@context":"https://schema.org","@type":"FAQPage","@id":"https://daily.dev/posts/fixing-my-usb3-2-5gbe-network-adapters-on-linux-proxmox--sxlgodstb#faq","mainEntity":[{"@type":"Question","name":"How do I fix my Realtek USB 2.5GbE adapter not working properly on Linux or Proxmox?","acceptedAnswer":{"@type":"Answer","text":"Create a udev rules file that sets the correct USB bConfigurationValue for the Realtek adapter. The rule targets vendor ID 0bda and product IDs 8152, 8153, 8155, 8156, forcing the device into the correct configuration mode (MODE1=1 for most adapters). After adding the file and rebooting, the proper kernel driver loads, yielding roughly 1.5 Gbps full duplex and 1.9 Gbps half duplex throughput. Developers and homelabbers troubleshooting Linux networking hardware find fixes like this on daily.dev."}}]}
```

