Wenn der ZimaOS-Installer bei „Searching for network address“ hängen bleibt und nie eine IP-Adresse erhält, sollten Sie zunächst feststellen, ob der Ethernet-Controller überhaupt erkannt wird und eine Verbindung besteht. In diesem Fall vom Dezember 2025 verwendete ein System mit Gigabyte X870I Aorus Pro Ice einen Realtek-RTL8125D-2,5-GbE-Controller, und der Installer kam nie zu einer nutzbaren Netzwerkadresse.
Ein Community-Mitglied führte diesen konkreten Fehler auf die Treiberunterstützung im damals verfügbaren Installer-Build zurück und schlug vorübergehend Ethernet über USB vor. Der Thread enthielt keine Bestätigung durch die IceWhale-Entwicklung und keinen späteren Test mit aktuellem ZimaOS. Daher sollte daraus nicht dauerhaft abgeleitet werden, dass RTL8125D nicht unterstützt wird.
Der Installer hatte keine Adresse anzuzeigen
Der Benutzer erreichte die Installationsphase, in der nach einer Adresse gesucht wird, erhielt jedoch keine IP-Adresse. Das unterscheidet sich davon, dass ein Browser ZimaOS nicht öffnen kann, obwohl der Host bereits eine gültige DHCP-Lease erhalten hat.
Prüfen Sie zuerst die physische Verbindung: Kabel, Switch- oder Router-Port sowie die Verbindungs-LEDs. Sehen Sie anschließend in der DHCP-Client-Liste des Routers nach. Wenn der Rechner dort nie erscheint, liegt der Fehler unterhalb der Browserebene und kann die Erkennung der Netzwerkkarte, die Treiberbindung, DHCP oder den physischen Netzwerkpfad betreffen.
Die Erklärung zum RTL8125D war eine Diagnose aus der Community
Der Benutzer identifizierte den integrierten Controller als Realtek RTL8125D. Eine Antwort aus der Community besagte, dass der Ende 2025 verwendete ZimaOS-Installer-Kernel keine funktionierende Unterstützung für diesen Controller enthielt und der Treiber nicht einfach in den laufenden Installer eingebunden werden konnte.
Diese Erklärung passte zum Fehlerbild, aber der Thread enthielt weder Kernel-Protokolle noch lspci -k noch eine offizielle Kompatibilitätsaussage. Außerdem stammt er aus der Zeit vor späteren ZimaOS-Versionen. Verwenden Sie ihn als historisches Diagnosebeispiel, nicht als Beleg für das aktuelle Image.
Die aktuelle ZimaOS-Dokumentation beschreibt x86-64-Hardware allgemein, enthält jedoch keine vollständige Kompatibilitätstabelle für Netzwerkkarten. Wenn Sie heute denselben Controller verwenden, testen Sie den aktuellen Installer, bevor Sie annehmen, dass die frühere Einschränkung noch besteht.
Ein vorübergehender USB-Ethernet-Adapter kann das Problem eingrenzen
Der im Thread vorgeschlagene praktische Workaround bestand darin, die Installation über einen unterstützten USB-Ethernet-Adapter durchzuführen. In der Antwort wurden gängige USB-NIC-Familien wie RTL8153 und AX88179 genannt. Der ursprüngliche Verfasser bestellte einen Adapter, meldete sich jedoch nicht mit einem abschließenden Installationsergebnis zurück.
Ein vorübergehender Adapter ist hilfreich, weil sich damit die Kompatibilität des Netzwerkcontrollers vom restlichen Installationsprozess trennen lässt. Wenn ZimaOS über USB-Ethernet eine Adresse erhält und die Einrichtung abschließt, ist der integrierte NIC-Pfad der Hauptverdächtige. Wenn auch der USB-Adapter keine DHCP-Lease erhält, sollten Sie Switch, Router, Verkabelung, VLAN und DHCP-Dienst untersuchen, bevor Sie den integrierten Controller verantwortlich machen.
Testen Sie den aktuellen Installer erneut, bevor Sie aus einem alten Treiberproblem Schlussfolgerungen ziehen
ZimaOS hat Netzwerk treiber laufend ergänzt und überarbeitet. So fügte ZimaOS 1.7.1 beispielsweise ausdrücklich be2net-Unterstützung für bestimmte Emulex-NICs hinzu und verbesserte die Docker-Netzwerkfunktionen. Das zeigt, dass sich die Netzwerkunterstützung zwischen Versionen ändern kann. Im Changelog von 1.7.1 wird jedoch nicht ausdrücklich eine Fehlerbehebung für RTL8125D genannt.
Aktuelle Versionshinweise zu ZimaOS 1.7.1 bieten eine verlässlichere Versionsgrenze, als sich auf eine Forumsannahme aus dem Dezember 2025 zu stützen.
Was Sie erfassen sollten, wenn der aktuelle Installer weiterhin fehlschlägt
Wenn das Problem auch in einem aktuellen Build auftritt, notieren Sie das Motherboard-Modell und die Revision, den genauen NIC-Controller, die Version des ZimaOS-Images, ob die Verbindungs-LEDs leuchten, ob der Router eine Lease vergibt und ob ein bewährter USB-Ethernet-Adapter funktioniert.
Wenn Sie eine Shell erreichen, erfassen Sie lspci -nnk, ip link und relevante Kernelmeldungen, ohne Treiber zu verändern. Diese Ausgaben können zwischen „Gerät nicht erkannt“, „Treiber nicht gebunden“, „Verbindung getrennt“ und „DHCP fehlgeschlagen“ unterscheiden. Dabei handelt es sich um sehr unterschiedliche Fehler, auch wenn der Installer möglicherweise für alle denselben Wartestatus anzeigt.
