1. Introducción
¡Estamos emocionados de anunciar que HA over iHost ya está oficialmente disponible! Este proyecto trae el completo Sistema Operativo Home Assistant a la SONOFF iHost plataforma, ofreciendo a los usuarios una nueva forma potente de ejecutar Home Assistant localmente en hardware iHost.
Nacido de necesidades reales de la comunidad y exploración técnica impulsada por usuarios, esta iniciativa refleja la creatividad y pasión de las comunidades de usuarios de Home Assistant y SONOFF. Muchos usuarios de iHost ya han estado ejecutando Home Assistant Core en Docker en el sistema nativo para aprovechar su hardware. Algunos usuarios avanzados fueron aún más allá, modificando y compilando sus propias versiones para ejecutar el sistema completo Home Assistant OS de forma nativa en iHost.
En esta guía, te mostraré cómo ejecutar fácilmente Home Assistant en tu SONOFF iHostRecorreremos dos métodos de grabación: usando Balena Etcher o Raspberry Pi Imager¡Comencemos!
Mira el tutorial en video detallado aquí:
2. Requisitos previos
- Se requiere un SONOFF iHost.
- Asegúrate der iHost la versión del sistema es 2.5.1 o posterior.
- Una Clase de Aplicación 2 (A2) tarjeta, con una capacidad mínima de 32GB, se recomienda para un mejor rendimiento, especialmente en operaciones pequeñas de lectura y escritura.
- Como iHost está basado en un procesador de 32 bits, algunas funciones de Home Assistant pueden no ser compatibles.


3. Preparando la tarjeta Micro SD
Hardware requerido
- Se recomienda una tarjeta (Clase de Aplicación 2) (A2) con una capacidad mínima de 32GB para un mejor rendimiento, especialmente en operaciones pequeñas de lectura y escritura. Sugerimos usar una tarjeta TF de SanDisk, Kingston o Samsung. Internamente hemos estado usando estas marcas para pruebas.
- Un lector de tarjetas SD: cualquier lector USB estándar funcionará si tu portátil no tiene lector SD incorporado.
Software requerido
- Herramienta para grabar tarjeta Micro SD: Balena Etcher o Raspberry Pi Imager, etc.
- Visita el proyecto en GitHub para la imagen correspondiente de HA over iHost: iHost-Open-Source-Project.

4. Grabando la imagen HA Over iHost en la tarjeta Micro SD
-
Grabar con Balena Etcher
- Inserta la tarjeta Micro SD en el lector de tarjetas y conéctalo a tu computadora.
- Descarga y ejecuta Etcher.

- Haz clic Grabar desde archivo, luego selecciona ele HA over iHost imagen archivo descargado en tu computadora.

2. Haz clic Seleccionar destino, luego elige la tarjeta Micro SD que insertaste.
*Nota: ¡Por favor asegúrate de seleccionar la unidad correcta!

3. Haz clic ¡Grabar! para comenzar a grabar ele HA over iHost imagen en la tarjeta Micro SD.
*Nota: No retires ni uses la tarjeta SD durante el proceso de grabación.
-
Grabar con Raspberry Pi Imager
- Inserta la tarjeta SD en el lector de tarjetas y conéctalo a tu computadora.
- Descarga y ejecuta Raspberry Pi Imager.

- Haz clic ELEGIR DISPOSITIVO > Sin filtro.

- Haz clic ELEGIR SISTEMA OPERATIVO > Usar personalizado, luego selecciona el archivo de imagen HA over iHost descargado en tu computadora.


-
Haz clic ELEGIR ALMACENAMIENTO, luego elige la tarjeta Micro SD que insertaste.
*Nota: ¡Por favor asegúrate de seleccionar la tarjeta Micro SD correcta!

- Haz clic SIGUIENTE > NO, BORRAR AJUSTES, y confirma para borrar todos los ajustes en la tarjeta SD.



-
Comienza a flashear la imagen HA sobre iHost en la tarjeta SD insertada.
*Nota: No interactúes con la tarjeta SD (por ejemplo, desconectándola o modificando archivos) durante el proceso de flasheo.


5. Arranque Sistema operativo Home Assistant en iHost
Migrar dispositivos Zigbee (Opcional)
Si no necesitas migrar dispositivos Zigbee, pasa a la siguiente sección.
iHost te permite exportar y migrar los datos de dispositivos Zigbee de iHost a Home Assistant descargando el archivo de respaldo disponible enpara restaurar en Home Assistant integrado con ZHA/Zigbee2MQTT. Solo se migran la red Zigbee y el estado de los dispositivos. No se incluyen temporizadores, grupos, escenas ni nombres de dispositivos. Haz clic aquí para aprender: ¿Cómo restaurar?
Botasistema operativo Home Assistant en iHost
- Inserta la tarjeta Micro SD pre-flasheada en la ranura SD del iHost.
- Conecta iHost a un cable de red y enciéndelo.
- Dentro de 5 segundos después de encender, presiona repetidamente el botón de Silencio (♪) en la parte superior del iHost hasta que la Tira lateral LED entre en un patrón de luz respiratoria AZUL . Esto indica que el sistema está cambiando al sistema operativo Home Assistant flasheado en la tarjeta SD.

-
Si el indicador LED muestra un AZUL patrón de luz respiratoria, puedes acceder a la nueva interfaz web de Home Assistant dentro de los próximos 10 minutos. El primer arranque puede tardar más.
En un navegador de escritorio, ingresa homeassistant.local:8123.
*Nota: Si usas una versión antigua de Windows o tienes configuraciones de red más estrictas, puede que necesites acceder a Home Assistant usando una de las siguientes URLs:
http://homeassistant:8123 o http://X.X.X.X:8123 (reemplaza X.X.X.X con la dirección IP de tu Raspberry Pi)
Solución de problemas de fallos de arranque
- Si elLa tira lateral LED nono muestra un AZUL patrón de luz respiratoriarn pero un ROJO patrón de luz respiratoria después deo al encender durante 5 segundos o después de presionar el botón varias veces, el arranque ha fallado. Intenta reiniciar elel sistema operativo Home Assistant como siguesigue:
- Reinicia iHost;
- No es necesario presionar ningún botón.
- iHost intenta arrancarno el sistema operativo Home Assistant desdede la tarjeta SD.

- Si no puedes acceder a la interfaz web de Home Assistant dentro de los 10 minutos posteriores a las operaciones anteriores, puede deberse a una imagen mal flasheada. Intenta volver a flashear la tarjeta SD o usar una nueva.
6. Volver aa eWeLink CUBE
- Para volver aa eWeLink CUBE, fSigue estos pasos:
- Reinicia iHost.
- Presiona repetidamente el botón de silencio (♪) una vez dentro de 3 segundos.
- El LED Tira lateral concambiará a un ROJO patrón de luz fluida, confirmando que el sistema ha vuelto a eWeLink CUBE.

*Notas:
- Si varios dispositivos están funcionandong Sistema operativo Home Assistant en tu red, el nombre de host [homeassistant.local] puede no resolverse correctamente. Puedes descubrir la dirección IP correcta a través de la interfaz de gestión de tu router o transmitiendo el servicio mDNS [_home-assistant._tcp.].
- Si el último arranque fue desde la tarjeta SD, y la tarjeta se retira sin cambiar de nuevo a eWeLink CUBE, ela tira lateral LED mostrará mostrar un ROJO patrón de luz respiratoria, indicando que Home Assistant Operating System no pudo arrancar en iHost.
7. Recursos de hardware
Encendidoce Home Assistant Operating System está succfuncionando correctamente en iHost, puedes usar los siguientes hardwares integrados compatibles:
Botón e indicador LED
El complemento de control de hardware iHost permite controlar los botones e indicadores LED de iHost en Home Assistant. Los registra como dispositivos y entidades separadas, permitiendo a los usuarios usarlos en automatizaciones para interacciones de hardware más flexibles.(por ejemplo, activar la entidad del botón de encendido para apagar iHost). Para más detalles, consulta la Complemento de control de hardware iHost guía.
Bluetooth
- Modelo del chipset: RTL8723DS
- Ruta: Configuración > Dispositivos y servicios > Integraciones > Bluetooth
- Descubrimiento: Automático

Wi-Fi
- Modelo del chipset: RTL8723DS
- Ruta: Configuración > Sistema > Red > Configurar interfaces de red > WLAN0
- Descubrimiento: Automático

Coordinador Zigbee
- Modelo del chipset: 00.21.05.0009 SOC EFR32MG21A020F768IM32-B SiliconLabs QFN32-4*4 (RAM 64kB, Flash 768kB)
- Ruta: Configuración > Sistema > Hardware > Todo el hardware > /dev/ttyS4
- Descubrimiento: A través de Zigbee Home Automation (ZHA) o Zigbee2MQTT

7. Acerca de la imagen CoreBox
CoreBox es una nueva imagen de HA sobre iHost diseñada para una configuración rápida, con la última versión de HA Core (2025.05.03) preintegrada.
Con CoreBox, ya no necesitas esperar durante la instalación inicial a que el dispositivo descargue HA Core desde GitHub. En su lugar, puedes arrancar directamente desde la versión integrada de HA Core, logrando el inicio en 3 minutos o incluso menos. CoreBox elimina la dependencia de la conexión a internet, permitiendo una configuración fácil incluso en entornos sin conexión. Aún puedes actualizar a versiones más recientes de HA Core desde el sistema una vez que esté en funcionamiento.
¿Por qué CoreBox?
Hemos estado escuchando atentamente tus comentarios. Muchos usuarios reportaron que el proceso original de instalación de HA sobre iHost a menudo fallaba debido a una conexión a internet pobre o inestable, especialmente durante la descarga inicial de HA Core. Esto no solo causaba frustración, sino que también desanimaba a muchos usuarios primerizos a continuar.
Incluso con nuestro soporte en línea, solucionar problemas de red y guiar en el proceso de instalación a menudo tomaba más tiempo del esperado — tanto para los usuarios como para nuestro equipo.
Por eso creamos CoreBox — una solución diseñada desde la perspectiva del usuario.
Con CoreBox, obtienes:
- Una experiencia de configuración rápida y confiable
- No más retrasos ni instalaciones fallidas debido a problemas de red
- Confianza de que tu Home Assistant funcionará sin problemas — en cualquier momento y lugar
¿Puedo actualizar el núcleo incorporado de HA?
¡Sí! Una vez que HA arranca con la versión incorporada (2025.5.3), Home Assistant detectará si hay una versión más reciente disponible. Puedes actualizar el núcleo de HA como de costumbre desde la página Configuración > Sistema > Actualizaciones — igual que una instalación normal.
9. Complementos compatibles
-
Ahora disponible:
-
Complemento iHost Hardware Control
Controla botones físicos, indicadores RGB y tiras de luz directamente desde Home Assistant.
Mapea entradas de hardware a automatizaciones para una interacción fluida entre entornos físicos y virtuales.
Puedes hacer clic aquí para el tutorial. -
Complemento MG21 Flashing : Actualiza el firmware MG21, con soporte opcional para flashear pilas Zigbee o Thread.
Puedes hacer clic aquí para el tutorial. -
Node-Red : Este complemento es una versión empaquetada independiente de Node-RED, diseñada exclusivamente para soportar la arquitectura linux/arm/v7. Ha sido empaquetado por SONOFF, específicamente adaptado para usuarios de iHost.
Puedes hacer clic aquí para el tutorial. -
Complemento Matter Bridge : Conecta dispositivos locales al ecosistema Matter para integración multiplataforma.
Puedes hacer clic aquí para el tutorial.
-
10. Agradecimientos
Este proyecto es un desarrollo derivado basado en Darkxst’s [ha-operating-system] proyecto de GitHub. Agradecemos sinceramente al autor original por sus contribuciones fundamentales.




















































3 comentarios
Bertrand
Good project
Mia Ma
回复鄭先生: 会在,HAOS是装在新的SD卡上,不会影响原本的CUBE系统。
鄭先生
請問已安裝CUBE使用一段時間,後來安裝HAOS使用一陣子不習慣
如果切換回CUBE,原本的CUBE資料還會在嗎?
HAOS資料還回在嗎?
想切回CUBE試試看哪個適合我使用,但擔心要重新設定很麻煩很困擾
Dejar un comentario
Todos los comentarios se revisan antes de su publicación.
Este sitio está protegido por hCaptcha y se aplican la Política de privacidad de hCaptcha y los Términos del servicio.