Als het ZimaOS-installatieprogramma op ‘Searching for network address’ blijft staan en nooit een IP-adres ontvangt, bepaal dan eerst of de Ethernet-controller überhaupt wordt gedetecteerd en een verbinding heeft. In dit geval uit december 2025 gebruikte een systeem met een Gigabyte X870I Aorus Pro Ice-moederbord een Realtek RTL8125D 2,5GbE-controller en kwam het installatieprogramma nooit toe aan een bruikbaar netwerkadres.
Een communitylid schreef die specifieke fout toe aan driverondersteuning in de installatiebuild die op dat moment beschikbaar was en stelde tijdelijk USB-Ethernet voor. In de discussie stond geen bevestiging van IceWhale-engineers en er was ook geen latere test met de huidige versie van ZimaOS. Maak er daarom geen permanente bewering van dat RTL8125D niet wordt ondersteund.
Het installatieprogramma had geen adres om weer te geven
De gebruiker bereikte de installatiefase waarin naar een adres wordt gezocht, maar ontving geen IP-adres. Dat is iets anders dan wanneer een browser ZimaOS niet kan openen nadat de host al een geldige DHCP-lease heeft gekregen.
Controleer eerst de fysieke verbinding: de kabel, de poort op de switch of router en de verbindingsleds. Bekijk daarna de lijst met DHCP-clients op de router. Als de machine daar nooit verschijnt, zit de fout onder het niveau van de browser en kan deze te maken hebben met NIC-detectie, het koppelen van de driver, DHCP of het fysieke netwerkpad.
De verklaring voor RTL8125D was een diagnose uit de community
De gebruiker identificeerde de ingebouwde controller als een Realtek RTL8125D. Een communitylid stelde dat de kernel van het ZimaOS-installatieprogramma dat eind 2025 werd gebruikt, geen werkende ondersteuning voor die controller bevatte en dat de driver niet zomaar in het actieve installatieprogramma kon worden geïnjecteerd.
Die verklaring paste bij het symptoom, maar in de discussie stonden geen kernellogs, lspci -k of officiële compatibiliteitsverklaring. Bovendien dateert deze van vóór latere ZimaOS-releases. Gebruik dit als historisch diagnosepatroon, niet als bewijs voor de huidige image.
De huidige ZimaOS-documentatie beschrijft x86-64-hardware in algemene termen, maar bevat geen volledige compatibiliteitstabel voor NIC's. Als je tegenwoordig dezelfde controller hebt, test dan eerst het nieuwste installatieprogramma voordat je aanneemt dat de oude beperking nog steeds geldt.
Een tijdelijke USB-Ethernetadapter kan het probleem isoleren
De praktische workaround die in de discussie werd voorgesteld, was installeren via een ondersteunde USB-Ethernetadapter. In het antwoord werden veelvoorkomende USB-NIC-families genoemd, zoals RTL8153 en AX88179. De oorspronkelijke poster bestelde een adapter, maar kwam niet terug met het uiteindelijke installatieresultaat.
Een tijdelijke adapter is waardevol omdat je daarmee compatibiliteit van de netwerkcontroller kunt onderscheiden van de rest van de installatie. Als ZimaOS via USB-Ethernet een adres krijgt en de installatie voltooit, wordt het pad van de ingebouwde NIC de hoofdverdachte. Als ook de USB-adapter geen DHCP-lease krijgt, onderzoek dan de switch, router, bekabeling, VLAN en DHCP-service voordat je de ingebouwde controller de schuld geeft.
Test het huidige installatieprogramma opnieuw voordat je een oude driverconclusie trekt
ZimaOS is netwerkdrivers blijven toevoegen en aanpassen. Zo voegde ZimaOS 1.7.1 expliciet ondersteuning voor be2net toe voor bepaalde Emulex-NIC's en werd de Docker-netwerkfunctionaliteit verbeterd. Dat laat zien dat netwerkondersteuning per release verandert. In de changelog van 1.7.1 wordt niet specifiek beweerd dat er een oplossing voor RTL8125D is toegevoegd.
De huidige releaseopmerkingen van ZimaOS 1.7.1 vormen een betere versiegrens dan uitgaan van een aanname op een forum uit december 2025.
Wat je moet vastleggen als het nieuwste installatieprogramma nog steeds faalt
Als hetzelfde probleem optreedt in een huidige build, noteer dan het model en de revisie van het moederbord, de exacte NIC-controller, de versie van de ZimaOS-image, of de verbindingsleds branden, of de router een lease verstrekt en of een goed werkende USB-Ethernetadapter functioneert.
Als je een shell kunt openen, leg dan lspci -nnk, ip link en relevante kernelberichten vast zonder drivers te wijzigen. Met die uitvoer kun je onderscheid maken tussen ‘apparaat niet gedetecteerd’, ‘driver niet gekoppeld’, ‘verbinding is uitgeschakeld’ en ‘DHCP mislukt’. Dat zijn heel verschillende fouten, ook al kan het installatieprogramma voor alle gevallen hetzelfde wachtscherm tonen.
