Om ZimaOS-installationsprogrammet fastnar på ”Searching for network address” och aldrig får någon IP-adress bör du först ta reda på om Ethernet-kontrollern över huvud taget identifieras och har länk. I det här fallet från december 2025 använde ett system med Gigabyte X870I Aorus Pro Ice en Realtek RTL8125D 2.5GbE-kontroller, och installationsprogrammet kom aldrig vidare till en användbar nätverksadress.
En person i communityt hänförde det specifika felet till drivrutinsstödet i den installationsversion som fanns tillgänglig då och föreslog tillfälligt Ethernet via USB. Tråden innehöll ingen bekräftelse från IceWhales ingenjörer och inte heller något senare test med aktuell ZimaOS, så detta bör inte omvandlas till ett permanent påstående om att RTL8125D saknar stöd.
Installationsprogrammet hade ingen adress att visa
Användaren nådde installationssteget där en adress söks, men fick ingen IP-adress. Det skiljer sig från att en webbläsare inte kan öppna ZimaOS efter att värddatorn redan har fått en giltig DHCP-tilldelning.
Kontrollera den fysiska länken först: kabeln, porten på switchen eller routern samt länkdioderna. Titta sedan i routerns lista över DHCP-klienter. Om datorn aldrig visas där ligger felet under webbläsarnivå och kan beröra identifiering av nätverkskortet, drivrutinsbindning, DHCP eller den fysiska nätverksvägen.
Förklaringen om RTL8125D var en diagnos från communityt
Användaren uppgav att den inbyggda kontrollern var en Realtek RTL8125D. Ett svar från communityt hävdade att kärnan i ZimaOS-installationsprogrammet som användes i slutet av 2025 saknade fungerande stöd för den kontrollern och att drivrutinen inte enkelt kunde läggas till i det körande installationsprogrammet.
Förklaringen stämde med symtomen, men tråden visade varken kärnloggar, lspci -k eller något officiellt kompatibilitetsuttalande. Den föregår dessutom senare ZimaOS-versioner. Använd den som ett historiskt diagnosmönster, inte som bevis för hur den aktuella avbildningen fungerar.
Den aktuella ZimaOS-dokumentationen beskriver x86-64-maskinvara på en övergripande nivå, men innehåller ingen fullständig kompatibilitetstabell för nätverkskort. Om du har samma kontroller i dag bör du testa det senaste installationsprogrammet innan du antar att den gamla begränsningen fortfarande gäller.
En tillfällig USB-Ethernetadapter kan avgränsa problemet
Den praktiska lösning som föreslogs i tråden var att installera via en USB-Ethernetadapter med stöd. Svaret nämnde vanliga USB-nätverkskortsfamiljer som RTL8153 och AX88179. Den ursprungliga skribenten beställde en adapter, men återkom inte med något slutligt installationsresultat.
En tillfällig adapter är värdefull eftersom den skiljer kompatibilitet med nätverkskontrollern från resten av installationen. Om ZimaOS får en adress och slutför konfigurationen via USB-Ethernet blir den inbyggda nätverkskortsvägen huvudmisstänkt. Om USB-adaptern inte heller får någon DHCP-tilldelning bör du undersöka switchen, routern, kablaget, VLAN och DHCP-tjänsten innan du skyller på den inbyggda kontrollern.
Testa om med det aktuella installationsprogrammet innan du drar slutsatser om den gamla drivrutinen
ZimaOS har fortsatt att lägga till och ändra nätverksdrivrutiner. ZimaOS 1.7.1 lade till exempel uttryckligen till stöd för be2net för vissa Emulex-nätverkskort och förbättrade Docker-nätverk, vilket visar att nätverksstödet ändras mellan versioner. Ändringsloggen för 1.7.1 hävdar inte specifikt att en fix för RTL8125D ingår.
Det här bör du dokumentera om det senaste installationsprogrammet fortfarande misslyckas
Om samma problem uppstår i en aktuell version bör du dokumentera moderkortets modell och revision, den exakta nätverkskontrollern, ZimaOS-avbildningens version, om länkdioderna lyser, om routern tilldelar en adress och om en USB-Ethernetadapter som du vet fungerar kan ansluta.
Om du kan öppna ett skal bör du samla in lspci -nnk, ip link och relevanta kärnmeddelanden utan att ändra drivrutinerna. Utdata från dessa kommandon kan skilja mellan ”enheten identifieras inte”, ”ingen drivrutin är bunden”, ”länken är nere” och ”DHCP misslyckades”. Det är mycket olika fel, även om installationsprogrammet kan visa samma vänteskärm.
