1. Introduzione
Siamo entusiasti di annunciare che HA over iHost è ora ufficialmente disponibile! Questo progetto porta il sistema operativo Home Assistant completo sullaSONOFF iHost piattaforma, offrendo agli utenti un nuovo e potente modo per eseguire Home Assistant localmente sull'hardware iHost.
Nata dalle reali esigenze della community e dall'esplorazione tecnica guidata dagli utenti, questa iniziativa riflette la creatività e la passione delle community di utenti di Home Assistant e SONOFF. Molti utenti di iHost hanno già eseguito Home Assistant Core in Docker sul sistema nativo per sfruttarne l'hardware. Alcuni utenti esperti si sono spinti oltre, modificando e compilando le proprie build per eseguire nativamente l'intero sistema operativo Home Assistant su iHost.
In questa guida ti mostrerò come eseguire facilmente Home Assistant sul tuo SONOFF iHost. Illustreremo due metodi di flashing: utilizzando Balena Etcher oppure Raspberry Pi Imager. Iniziamo!

Guarda qui il video tutorial dettagliato:
2. Prerequisiti
- È richiesto un SONOFF iHost.
- Assicuratir iHost la versione del sistema deve essere la 2.5.1 o successiva.
- Una Application Class 2 (A2), con una capacità minima di 32 GB, è consigliata per ottenere prestazioni migliori, soprattutto nelle operazioni di lettura e scrittura di piccole dimensioni.
- Poiché iHost si basa su un processore a 32 bit, alcune funzionalità di Home Assistant potrebbero non essere compatibili.


3. Preparazione della scheda Micro SD
Hardware richiesto
- Si consiglia una scheda (Application Class 2) (A2), con una capacità minima di 32 GB, per ottenere prestazioni migliori, soprattutto nelle operazioni di lettura e scrittura di piccole dimensioni. Suggeriamo di utilizzare una scheda TF di SanDisk, Kingston o Samsung. Abbiamo utilizzato internamente queste schede di marca per i test.
- Un lettore di schede SD: qualsiasi lettore di schede USB standard funzionerà se il laptop non dispone di un lettore di schede SD integrato.
Software richiesto
- Strumento di flashing della scheda Micro SD: Balena Etcher oppure Raspberry Pi Imager, ecc.
- Visita il progetto GitHub per l'immagine corrispondente di HA over iHost: iHost-Open-Source-Project.

4. Esecuzione del flashing dell'immagine HA over iHost sulla scheda Micro SD
-
Esegui il flashing con Balena Etcher
- Inserisci la scheda Micro SD nel lettore di schede e collegalo al computer.
- Scarica ed esegui Etcher.

- Fai clic Esegui il flashing dal file, quindi seleziona ie HA over iHost immagine file scaricato sul computer.

2. Fai clic su Seleziona destinazione, quindi scegli la scheda Micro SD inserita.
*Nota: assicurati di selezionare l'unità corretta!

3. Fai clic su Esegui il flashing! per iniziare il flashing de HA over iHost immagine sulla scheda Micro SD.
*Nota: non rimuovere né utilizzare la scheda SD durante il processo di flashing.
-
Esegui il flashing con Raspberry Pi Imager
- Inserisci la scheda SD nel lettore di schede e collegalo al computer.
- Scarica ed esegui Raspberry Pi Imager.

- Fai clic SCEGLI DISPOSITIVO > Nessun filtro.

- Fai clic SCEGLI SISTEMA OPERATIVO > Usa personalizzato, quindi seleziona il file immagine HA over iHost scaricato sul computer.


-
Fai clic SCEGLI ARCHIVIO, quindi scegli la scheda Micro SD inserita.
*Nota: assicurati di selezionare la scheda Micro SD corretta!

- Fai clic AVANTI > NO, CANCELLA IMPOSTAZIONIe conferma per cancellare tutte le impostazioni sulla scheda SD.



-
Avvia il flashing dell'immagine HA su iHost sulla scheda SD inserita.
*Nota: non interagire con la scheda SD (ad esempio, non scollegarla né modificare i file) durante il processo di installazione.


5. Avvio Sistema operativo Home Assistant su iHost
Migrazione dei dispositivi Zigbee (facoltativa)
Se la migrazione dei dispositivi Zigbee non è necessaria, passa alla sezione successiva.
iHost consente di esportare e migrare i dati dei dispositivi Zigbee di iHost in Home Assistant scaricando il file di backup disponibileper eseguire il ripristino in Home Assistant integrato con ZHA/Zigbee2MQTT. Vengono migrati solo la rete Zigbee e lo stato dei dispositivi. Timer, gruppi, scene e nomi dei dispositivi non sono inclusi.
Fai clic qui per scoprire: Come si esegue il ripristino?
AvvioInstallazione del sistema operativo Home Assistant su iHost
- Inserisci la scheda Micro SD preinstallata nell'apposito slot per schede SD di iHost.
- Collega iHost a un cavo di rete e accendilo.
- Entro 5 secondi dall'accensione, premi ripetutamente il pulsante Muto (♪) sulla parte superiore di iHost finché la striscia LED laterale non entra in uno schema di illuminazione intermittente BLU . Questo indica che il sistema sta passando al sistema operativo Home Assistant installato sulla scheda SD.
*Nota: Il pulsante di accensione è il primo pulsante dall'alto, mentre il pulsante Muto (♪) è il terzo pulsante dall'alto (procedendo verso il basso). Per un riferimento visivo, consulta l'immagine qui sotto.
- Se l'indicatore LED mostra uno BLU schema di illuminazione intermittente, potrai accedere alla nuova interfaccia web di Home Assistant entro i 10 minuti successivi. Il primo avvio potrebbe richiedere più tempo.
In un browser desktop, inserisci homeassistant.local:8123.
*Nota:
- A partire da Home Assistant 2026.8, le nuove installazioni di Home Assistant OS non richiedono più :8123 nell'URL. Se utilizzi un'installazione esistente, la porta attuale rimane invariata e potresti dover continuare a usare homeassistant.local:8123
- Se utilizzi una versione precedente di Windows o configurazioni di rete più restrittive, potrebbe essere necessario accedere a Home Assistant utilizzando uno dei seguenti URL: http://homeassistant:8123 oppure http://X.X.X.X:8123 (sostituisci X.X.X.X con l'indirizzo IP del tuo Raspberry Pi)
Risoluzione dei problemi relativi agli errori di avvio
- Sela striscia LED laterale nonnon mostra uno BLU schema di illuminazione intermittenterna ma un mostrerà schema di illuminazione intermittente dopodopo 5 secondi dall'accensione o dopo aver premuto più volte il pulsante, l'avvio non è riuscito. Prova a riavviareil sistema operativo Home Assistant come seguews:
- Riavvia iHost;
- Non è necessario premere alcun pulsante.
- iHost tenta di avvil sistema operativo Home Assistant dadalla scheda SD.

- If you cannot access Home Assistant web interface within 10 minutes after the operations above, it may be due to an incorrectly flashed image. Try re-flashing the SD card or using a new one.
6. Switching Back tSe non è possibile accedere all’interfaccia web di Home Assistant entro 10 minuti dalle operazioni precedenti, potrebbe essere stata utilizzata un’immagine errata. Provare a eseguire nuovamente il flashing della scheda SD o a utilizzarne una nuova.
- 6. Tornare aeWeLink CUBEPer
- tornare a eWeLink CUBE,
- seguire questi passaggi:
- Riavviare iHost spegnendolo e riaccendendolo. Premere ripetutamente una sola volta il pulsante di disattivazione dell’audio (♪) entro 3 secondi.La striscia LED laterale mostrerà passerà a un

motivo di illuminazione intermittente, a conferma che il sistema è tornato a eWeLink CUBE.
- *Note:Se più dispositivi eseguono Home Assistant Operating System sulla rete
- Se più dispositivi eseguono Home Assistant Operating System sulla rete, il nome host [homeassistant.local] potrebbe non essere risolto correttamente. È possibile individuare l’indirizzo IP corretto tramite l’interfaccia di gestione del router oppure trasmettendo il servizio mDNS [_home-assistant._tcp.].Se l’ultimo avvio è avvenuto dalla scheda SD e la scheda viene rimossa senza tornare a eWeLink CUBE, l La striscia LED laterale mostrerà ROSSO un motivo di illuminazione intermittente,
segnalando che Home Assistant Operating System non è riuscito ad avviarsi su iHost.
7. Risorse hardwareQuando il sistemaHome Assistant Operating System è in esecuzione correttamente su iHost, è possibile utilizzare i seguenti componenti hardware integrati supportati:
Pulsante e indicatore LED
Il componente aggiuntivo iHost Hardware Control consente di controllare i pulsanti e gli indicatori LED di iHost in Home Assistant. Li registra come dispositivi ed entità separate, permettendo agli utenti di utilizzarli nelle automazioni per interazioni hardware più flessibili(ad esempio, attivando l’entità del pulsante di accensione per spegnere iHost). Per i dettagli, fare riferimento alla componente aggiuntivo iHost Hardware Control guida.
Bluetooth
- Modello del chipset: RTL8723DS
- Percorso: Impostazioni > Dispositivi e servizi > Integrazioni > Bluetooth
- Rilevamento: Automatico

Wi-Fi
- Modello del chipset: RTL8723DS
- Percorso: Impostazioni > Sistema > Rete > Configura interfacce di rete > WLAN0
- Rilevamento: Automatico

Zigbee CoCoordinatore
- Modello del chipset: 00.21.05.0009 SOC EFR32MG21A020F768IM32-B SiliconLabs QFN32-4*4 (RAM 64kB,Flash 768kB)
- Percorso: Impostazioni > Sistema > Hardware > Tutto l’hardware > /dev/ttyS4
- Rilevamento: Tramite Zigbee Home Automation (ZHA) o Zigbee2MQTT

8. Informazioni sull’immagine CoreBox
CoreBox è una nuova immagine di HA su iHost progettata per una configurazione rapida, con l’ultima versione di HA Core (2025.05.03) già integrata.
Con CoreBox non è più necessario attendere durante l’installazione iniziale che il dispositivo scarichi HA Core da GitHub. È invece possibile avviare direttamente la versione integrata di HA Core, completando l’avvio in 3 minuti o anche meno. CoreBox elimina la dipendenza dalla connessione Internet, consentendo una configurazione semplice anche in ambienti offline. Una volta avviato il sistema, è comunque possibile aggiornarlo alle versioni più recenti di HA Core.
Perché CoreBox?
Abbiamo ascoltato attentamente il vostro feedback. Molti utenti hanno segnalato che il processo di installazione originale di HA su iHost spesso non andava a buon fine a causa di una connessione Internet scadente o instabile, soprattutto durante il download iniziale di HA Core. Questo non solo causava frustrazione, ma scoraggiava anche molti utenti alle prime armi dal proseguire.
Anche con il nostro supporto online, la risoluzione dei problemi di rete e la guida attraverso il processo di installazione richiedevano spesso più tempo del previsto, sia per gli utenti sia per il nostro team.
Per questo abbiamo creato CoreBox, una soluzione progettata dal punto di vista dell’utente.
Con CoreBox ottieni:
- Un’esperienza di configurazione rapida e affidabile
- Niente più ritardi o installazioni non riuscite a causa di problemi di rete
- La certezza che Home Assistant funzioni senza problemi, sempre e ovunque
Posso aggiornare HA Core integrato?
Sì! Una volta avviato HA con la versione integrata (2025.5.3), Home Assistant rileverà se è disponibile una versione più recente. Puoi aggiornare HA Core normalmente dalla pagina Impostazioni > Sistema > Aggiornamenti, proprio come in un’installazione normale.
9. Componenti aggiuntivi supportati
-
Ora disponibile:
-
Componente aggiuntivo iHost Hardware Control
Controlla direttamente da Home Assistant i pulsanti fisici, gli indicatori RGB e le strisce luminose.
Mappa gli ingressi hardware sulle automazioni per un’interazione fluida tra gli ambienti fisici e virtuali.
Puoi fare clic qui per il tutorial. -
Componente aggiuntivo per il flashing di MG21 : aggiorna il firmware di MG21, con supporto opzionale al flashing degli stack Zigbee o Thread.
Puoi fare clic qui per il tutorial. -
Node-RED : questo componente aggiuntivo è una versione autonoma e pacchettizzata di Node-RED, progettata esclusivamente per supportare l’architettura linux/arm/v7. È stato pacchettizzato da SONOFF, appositamente per gli utenti di iHost.
Puoi fare clic qui per il tutorial. -
Componente aggiuntivo Matter Bridge : collega i dispositivi locali all’ecosistema Matter per l’integrazione multipiattaforma.
Puoi fare clic qui per il tutorial.
-
10. Riconoscimenti
Questo progetto è uno sviluppo derivato basato sul lavoro di Darkxst. [ha-operating-system] progetto da GitHub. Apprezziamo sinceramente l’autore originale per i suoi contributi fondamentali.



















































3 commenti
Bertrand
Good project
Mia Ma
回复鄭先生: 会在,HAOS是装在新的SD卡上,不会影响原本的CUBE系统。
鄭先生
請問已安裝CUBE使用一段時間,後來安裝HAOS使用一陣子不習慣
如果切換回CUBE,原本的CUBE資料還會在嗎?
HAOS資料還回在嗎?
想切回CUBE試試看哪個適合我使用,但擔心要重新設定很麻煩很困擾
Commenta
Nota che i commenti devono essere approvati prima di essere pubblicati.
Questo sito è protetto da hCaptcha e applica le Norme sulla privacy e i Termini di servizio di hCaptcha.