Se il programma di installazione di ZimaOS rimane bloccato su “Searching for network address” e non riceve mai un indirizzo IP, determina innanzitutto se il controller Ethernet viene rilevato ed è effettivamente collegato. In questo caso del dicembre 2025, un sistema Gigabyte X870I Aorus Pro Ice utilizzava un controller Realtek RTL8125D 2.5GbE e il programma di installazione non arrivava mai a ottenere un indirizzo di rete utilizzabile.
Un membro della community ha attribuito quel problema specifico al supporto dei driver nella versione del programma di installazione disponibile all'epoca e ha suggerito di usare temporaneamente una connessione Ethernet USB. La discussione non includeva una conferma da parte degli ingegneri di IceWhale né un test successivo su una versione corrente di ZimaOS, quindi non deve essere trasformata nell'affermazione permanente che RTL8125D non sia supportato.
Il programma di installazione non aveva alcun indirizzo da mostrare
L'utente era arrivato alla fase di installazione che cerca un indirizzo, ma non aveva ricevuto alcun IP. È diverso dal caso in cui un browser non riesca ad aprire ZimaOS dopo che l'host ha già ottenuto un lease DHCP valido.
Controlla innanzitutto il collegamento fisico: cavo, porta dello switch o del router e LED di collegamento. Controlla poi l'elenco dei client DHCP nel router. Se la macchina non compare mai, il problema si trova a un livello precedente rispetto al browser e può riguardare il rilevamento della scheda di rete, l'associazione del driver, il DHCP o il percorso fisico della rete.
La spiegazione relativa a RTL8125D era una diagnosi della community
L'utente originale aveva identificato il controller integrato come Realtek RTL8125D. Una risposta della community affermava che il kernel del programma di installazione di ZimaOS utilizzato alla fine del 2025 non includeva un supporto funzionante per quel controller e che il driver non poteva essere semplicemente inserito nel programma di installazione in esecuzione.
La spiegazione era compatibile con il sintomo, ma la discussione non mostrava i log del kernel, l'output di lspci -k né una dichiarazione ufficiale sulla compatibilità. Inoltre, precede le versioni successive di ZimaOS. Usala come modello di diagnosi storico, non come prova relativa all'immagine attuale.
La documentazione corrente di ZimaOS descrive in senso ampio l'hardware x86-64, ma non fornisce una tabella completa di compatibilità delle schede di rete. Se oggi disponi dello stesso controller, prova il programma di installazione più recente prima di presumere che la vecchia limitazione sia ancora valida.
Un adattatore Ethernet USB temporaneo può isolare il problema
La soluzione pratica proposta nella discussione consisteva nell'installare il sistema tramite un adattatore Ethernet USB supportato. La risposta menzionava famiglie comuni di schede di rete USB, come RTL8153 e AX88179. L'autore del post originale aveva ordinato un adattatore, ma non era poi tornato con il risultato finale dell'installazione.
Un adattatore temporaneo è utile perché separa i problemi di compatibilità del controller di rete dal resto dell'installazione. Se ZimaOS ottiene un indirizzo e completa la configurazione tramite Ethernet USB, il percorso della scheda di rete integrata diventa il principale sospettato. Se anche l'adattatore USB non ottiene un lease DHCP, verifica lo switch, il router, il cablaggio, la VLAN e il servizio DHCP prima di attribuire la colpa al controller integrato.
Ripeti il test con il programma di installazione corrente prima di concludere che il vecchio driver sia il problema
ZimaOS ha continuato ad aggiungere e modificare i driver di rete. Ad esempio, ZimaOS 1.7.1 ha aggiunto esplicitamente il supporto be2net per alcuni adattatori di rete Emulex e ha migliorato il networking di Docker, dimostrando che il supporto di rete cambia tra una versione e l'altra. Il changelog della versione 1.7.1 non afferma specificamente di aver risolto un problema con RTL8125D.
Note di rilascio dell'attuale versione ZimaOS 1.7.1 rappresentano un riferimento per la versione più affidabile rispetto al basarsi su un'ipotesi del forum del dicembre 2025.
Cosa raccogliere se il programma di installazione più recente continua a non funzionare
Se lo stesso problema si verifica su una versione corrente, annota il modello e la revisione della scheda madre, il controller di rete esatto, la versione dell'immagine di ZimaOS, se i LED di collegamento si accendono, se il router assegna un lease e se un adattatore Ethernet USB sicuramente funzionante opera correttamente.
Se riesci ad accedere a una shell, raccogli l'output di lspci -nnk, ip link e i messaggi del kernel pertinenti senza modificare i driver. Questi dati possono distinguere tra “dispositivo non rilevato”, “driver non associato”, “collegamento inattivo” e “DHCP non riuscito”: si tratta di problemi molto diversi, anche se il programma di installazione può mostrarli tutti con la stessa schermata di attesa.
