Deze installatiekwestie uit november 2025 is waardevol omdat de gebruiker uitzonderlijk grondige kruiscontroles uitvoerde voordat die om hulp vroeg. De onboard Realtek 2,5GbE-controller op een ASUS TUF Gaming B850M-PLUS WIFI7 werkte normaal onder Proxmox, Unraid en Kubuntu op dezelfde machine, met dezelfde kabel, switchpoorten en NVMe. Alleen ZimaOS slaagde er tijdens de tweede installatiefase niet in de interface te activeren.
Dit bewijs verlegt het probleem bij het troubleshooten weg van de router of kabel en richting de exacte NIC-revisie, de koppeling met het kernelstuurprogramma of de installeromgeving. De brondiscussie bereikte echter geen door IceWhale bevestigde hoofdoorzaak, dus de verklaring met het stuurprogramma moet een diagnose uit de community blijven.
De hardware en de fout waren zeer specifiek
De gemelde machine gebruikte een AMD Ryzen 7 8700G, 64 GB DDR5, een NVMe-systeemschijf van 512 GB en de onboard Realtek 2,5Gb-Ethernetcontroller van het moederbord. De eerste, vanaf USB gestarte fase van de ZimaOS-installatie werd normaal voltooid en kopieerde het systeem naar de NVMe.
De fout deed zich pas voor nadat de installer de gebruiker had gevraagd de USB-stick te verwijderen en op te starten vanaf de geïnstalleerde NVMe. Op dat moment had de omgeving van de tweede fase netwerktoegang nodig om de provisioning te voltooien, maar de Ethernet-interface kreeg geen carrier en geen DHCP-lease.
Wat de gebruiker tijdens de tweede fase waarnam
- De router toonde nooit een DHCP-lease voor de ZimaOS-installatie.
- De machine kon niet worden gepingd en er verscheen geen ZimaOS-webinterface.
- Een subnetscan vond geen nieuw serveradres.
-
ip atoonde alleen een loopbackinterface of een Ethernet-achtige interface zonder carrier en zonder IPv4-adres. - Herhaaldelijk gemaakte, nieuwe installatie-USB-sticks leverden hetzelfde resultaat op.
Deze symptomen verschillen van een werkende interface met alleen een verkeerd statisch IP-adres. De verbinding zelf werd niet bruikbaar in de geïnstalleerde ZimaOS-omgeving.
Waarom de andere besturingssystemen ertoe doen
Dezelfde onboard-NIC werkte direct onder Proxmox, Unraid en Kubuntu. De router wees DHCP-adressen toe, de linkleds werkten normaal en de machine was bereikbaar zonder extra stuurprogramma’s te installeren.
Dat bewijst niet dat ZimaOS een algemeen Realtek-probleem heeft. Het bewijst wel dat de fysieke netwerkkaart, bekabeling en switchverbinding konden werken, waardoor herhaaldelijk kabels verwisselen minder zinvol is nadat die controles al zijn geslaagd.
De theorie over r8169 versus r8125 kwam uit de community
Een beantwoorder uit de community vermoedde dat deze specifieke Realtek 2.5GbE-implementatie De theorie over r8169 versus r8125 kwam uit de community terwijl ZimaOS het koppelde aan r8169, of anders het verwachte stuurprogramma tijdens het opstarten van de tweede fase niet kon koppelen.
Dat is voor sommige Realtek-revisies aannemelijk, maar geen enkele IceWhale-medewerker heeft in de openbare discussie de apparaat-ID, geladen module of kernelregressie bevestigd. Herschrijf de theorie niet als “ZimaOS gebruikt het verkeerde stuurprogramma” zonder de daadwerkelijke diagnostische uitvoer.
De drie alleen-lezencontroles waarom de community vroeg
De beantwoorder vroeg om:
lspci -nn | grep -i ethernet
ip a
dmesg | grep -i -e r8169 -e r8125 -e realtekDeze opdrachten zijn nuttig omdat ze de installatie niet wijzigen. Samen laten ze de PCI-apparaat-ID zien, welke netwerkinterfaces Linux heeft aangemaakt en of relevante Realtek-stuurprogramma's fouten bij het detecteren of de verbinding hebben gemeld.
Vergelijk voor een actueel systeem ook de interface met de verwachte Ethernet-status in het huidige ZimaOS-netwerkpaneel. Als de kernel nooit een bruikbare interface aanmaakt, ligt het probleem vóór de configuratie in de webinterface.
Een compatibiliteitsvermelding op familieniveau is geen garantie voor elke revisie
De oorspronkelijke poster was begrijpelijkerwijs gefrustreerd, omdat de Realtek 2.5GbE-familie in de compatibiliteitsinformatie van IceWhale leek te staan en dat van invloed was op de aankoop van het moederbord. Netwerkcontrollers die onder vergelijkbare marketingnamen worden verkocht, kunnen toch verschillen in PCI-ID's, siliciumrevisies, firmware, PHY-componenten of bedrading op het moederbord.
Een compatibiliteitsrapport van hoge kwaliteit moet daarom de exacte lspci -nn identifier, niet alleen “Realtek 2.5GbE”.
De enige bevestigde uitkomst was een workaround met een Intel X540-T1
Zes dagen later meldde de oorspronkelijke gebruiker dat die een Intel X540-T1-NIC had gekocht en zei dat die het probleem omzeilde. Dat is de enige uitkomst die is bevestigd door de persoon die de fout ondervond.
De workaround bewijst dat ZimaOS kon doorgaan met de installatie wanneer een andere compatibele NIC netwerkverbinding leverde. Dit identificeert niet de exacte reden waarom het ingebouwde Realtek-apparaat niet werkte.
Wat deze thread niet aantoont
- Er wordt niet bewezen dat elke NIC uit de RTL8125-klasse op ZimaOS faalt.
- Er wordt niet bewezen dat DHCP de hoofdoorzaak was.
- Er wordt geen specifieke ontbrekende kernelmodule bevestigd.
- Er blijkt niet uit dat de levenslange licentie van de gebruiker invloed had op hardwareondersteuning.
- Er staat geen definitieve officiële driverfix van IceWhale in.
Een beter probleemoplossingspad voor vandaag
- Noteer de exacte PCI-ID van de NIC.
- Bevestig de link-leds en het gedrag van de routerpoort.
- Controleer of Linux een Ethernet-interface aanmaakt.
- Controleer de stuurprogrammaberichten voor de exacte controller.
- Vergelijk indien nodig het gedrag met een andere recente Linux-image.
- Als een tweede, aantoonbaar compatibele NIC ervoor zorgt dat ZimaOS de installatie voltooit, bewaar dan de diagnostische gegevens van de mislukte controller voor een compatibiliteitsrapport, in plaats van steeds opnieuw te installeren.
Veelgestelde vragen over de installatie van Realtek 2.5GbE
Was de ingebouwde NIC fysiek defect?
De kruistests spreken dat tegen. Het werkte direct onder verschillende andere besturingssystemen.
Was r8169 zeker het verkeerde stuurprogramma?
Nee. Dat was een theorie uit de community die in de openbare thread nooit werd bevestigd met de gevraagde uitvoer.
Welke workaround is bevestigd?
De oorspronkelijke gebruiker installeerde een Intel X540-T1-netwerkkaart en wist zo het installatieprobleem te omzeilen.
Moet ik mijn NIC vervangen voordat ik logboeken verzamel?
Verzamel indien mogelijk eerst de PCI-ID, de interfacestatus en relevante stuurprogrammaberichten. Die gegevens zijn veel nuttiger om te bepalen of een huidige ZimaOS-build nog steeds dezelfde compatibiliteitskloof heeft.
