1. Introduction
Nous sommes ravis d’annoncer que HA over iHost est désormais officiellement disponible ! Ce projet apporte le système complet Home Assistant Operating System sur le SONOFF iHost plateforme, offrant aux utilisateurs une nouvelle façon puissante d’exécuter Home Assistant localement sur le matériel iHost.
Né des besoins réels de la communauté et d’une exploration technique menée par les utilisateurs, cette initiative reflète la créativité et la passion des communautés d’utilisateurs Home Assistant et SONOFF. De nombreux utilisateurs d’iHost font déjà tourner Home Assistant Core dans Docker sur le système natif pour profiter de son matériel. Certains utilisateurs avancés sont allés plus loin en modifiant et compilant leurs propres versions pour exécuter le système complet Home Assistant OS nativement sur iHost.
Dans ce guide, je vais vous montrer comment exécuter facilement Home Assistant sur votre SONOFF iHost. Nous allons parcourir deux méthodes de flashage : en utilisant Balena Etcher ou Raspberry Pi Imager. Commençons !
Regardez le tutoriel vidéo détaillé ici :
2. Prérequis
- Un SONOFF iHost est requis.
- Assurez-vous der iHost la version du système est 2.5.1 ou ultérieure.
- Une Classe d’application 2 (A2) carte, d’une capacité minimale de 32 Go, est recommandée pour de meilleures performances, notamment lors des petites opérations de lecture et d’écriture.
- Comme iHost est basé sur un processeur 32 bits, certaines fonctionnalités de Home Assistant peuvent ne pas être compatibles.


3. Préparation de la carte Micro SD
Matériel requis
- Une carte (Application Class 2) (A2), d’une capacité minimale de 32 Go, est recommandée pour de meilleures performances, notamment lors des petites opérations de lecture et d’écriture. Nous suggérons d’utiliser une carte TF de SanDisk, Kingston ou Samsung. Nous utilisons en interne ces marques pour les tests.
- Un lecteur de carte SD : tout lecteur USB standard fonctionnera si votre ordinateur portable n’a pas de lecteur SD intégré.
Logiciel requis
- Outil de flashage de carte Micro SD : Balena Etcher ou Raspberry Pi Imager, etc.
- Visitez le projet GitHub pour l’image correspondante de HA over iHost : iHost-Open-Source-Project.

4. Flashage de l’image HA Over iHost sur la carte Micro SD
-
Flasher avec Balena Etcher
- Insérez la carte Micro SD dans le lecteur de carte et connectez-le à votre ordinateur.
- Téléchargez et lancez Etcher.

- Cliquez Flasher depuis un fichier, puis sélectionnez lee HA over iHost image fichier téléchargé sur votre ordinateur.

2. Cliquez Sélectionner la cible, puis choisissez la carte Micro SD que vous avez insérée.
*Remarque : Veuillez vous assurer de sélectionner le bon lecteur !

3. Cliquez Flasher ! pour commencer le flashagee HA over iHost image sur la carte Micro SD.
*Remarque : Ne retirez pas et n’utilisez pas la carte SD pendant le processus de flashage.
-
Flasher avec Raspberry Pi Imager
- Insérez la carte SD dans le lecteur de carte et connectez-le à votre ordinateur.
- Téléchargez et lancez Raspberry Pi Imager.

- Cliquez CHOISIR L’APPAREIL > Aucun filtrage.

- Cliquez CHOISIR LE SYSTÈME D’EXPLOITATION > Utiliser un fichier personnalisé, puis sélectionnez le fichier image HA over iHost téléchargé sur votre ordinateur.


-
Cliquez CHOISIR LE STOCKAGE, puis choisissez la carte Micro SD que vous avez insérée.
*Remarque : Veuillez vous assurer de sélectionner la bonne carte Micro SD !

- Cliquez SUIVANT > NON, EFFACER LES PARAMÈTRES, et confirmez pour effacer tous les paramètres sur la carte SD.



-
Commencez à flasher l'image HA over iHost sur la carte SD insérée.
*Note : Ne pas interagir avec la carte SD (par exemple, la débrancher ou modifier les fichiers) pendant le processus de flashage.


5. Démarrage Système d'exploitation Home Assistant sur iHost
Migrer les appareils Zigbee (optionnel)
Si la migration des appareils Zigbee n'est pas nécessaire, passez à la section suivante.
iHost vous permet d'exporter et de migrer les données des appareils Zigbee d'iHost vers Home Assistant en téléchargeant le fichier de sauvegarde disponible tpour restaurer dans Home Assistant intégré avec ZHA/Zigbee2MQTT. Seuls le réseau Zigbee et le statut des appareils sont migrés. Les minuteries, groupes, scènes et noms d'appareils ne sont pas inclus. Cliquez ici pour en savoir plus : Comment restaurer ?
Botteng Système d'exploitation Home Assistant sur iHost
- Insérez la carte Micro SD pré-flashée dans le slot SD de l'iHost.
- Connectez l'iHost à un câble réseau et allumez-le.
- Dans les 5 secondes suivant la mise sous tension, appuyez plusieurs fois sur le bouton Muet (♪) en haut de l'iHost jusqu'à ce que la bande LED latérale affiche un motif lumineux BLEU respirant. Cela indique que le système bascule vers le système d'exploitation Home Assistant flashé sur la carte SD.

-
Si l'indicateur LED affiche un BLEU motif lumineux respirant, vous pouvez accéder à votre nouvelle interface web Home Assistant dans les 10 minutes suivantes. Le premier démarrage peut prendre plus de temps.
Dans un navigateur de bureau, saisissez homeassistant.local:8123.
*Note : Si vous utilisez une version plus ancienne de Windows ou avez des configurations réseau plus strictes, vous devrez peut-être accéder à Home Assistant via l'une des URL suivantes :
http://homeassistant:8123 ou http://X.X.X.X:8123 (remplacez X.X.X.X par l'adresse IP de votre Raspberry Pi)
Dépannage des échecs de démarrage
- Si leLa bande LED latérale nene montre pas un BLEU motif lumineux respirantretour mais un ROUGE motif lumineux respirant aprèsaprès avoir été allumé pendant 5 secondes ou après avoir appuyé plusieurs fois sur le bouton, le démarrage a échoué. Essayez de redémarrer lele système d'exploitation Home Assistant comme suitws :
- Redémarrez iHost ;
- Aucune pression de bouton n'est nécessaire.
- iHost tente de démarrerpas le système d'exploitation Home Assistant frdepuis la carte SD.

- Si vous ne pouvez pas accéder à l'interface web de Home Assistant dans les 10 minutes suivant les opérations ci-dessus, cela peut être dû à une image mal flashée. Essayez de re-flasher la carte SD ou d'en utiliser une nouvelle.
6. Retour àvers eWeLink CUBE
- Pour revenir àvers eWeLink CUBE, fSuivez ces étapes :
- Redémarrez iHost.
- Appuyez plusieurs fois sur le bouton muet (♪) en moins de 3 secondes.
- La LED Bande latérale wpassera à un ROUGE motif lumineux fluide, confirmant que le système est revenu à eWeLink CUBE.

*Notes :
- Si plusieurs appareils fonctionnentng Système d'exploitation Home Assistant sur votre réseau, le nom d’hôte [homeassistant.local] peut ne pas se résoudre correctement. Vous pouvez découvrir l’adresse IP correcte via l’interface de gestion de votre routeur ou en diffusant le service mDNS [_home-assistant._tcp.].
- Si le dernier démarrage a été effectué depuis la carte SD, et que la carte est retirée sans revenir à eWeLink CUBE, lLa bande LED latérale va afficher un ROUGE motif de lumière respirante, indiquant que Home Assistant Operating System n’a pas réussi à démarrer sur iHost.
7. Ressources matérielles
Activéce Home Assistant Operating System fonctionne avec succèsfonctionnant avec succès sur iHost, vous pouvez utiliser les matériels embarqués suivants pris en charge :
Bouton & indicateur LED
Le module complémentaire iHost Hardware Control permet de contrôler les boutons et les indicateurs LED d’iHost dans Home Assistant. Il les enregistre comme appareils et entités distinctes, permettant aux utilisateurs de les utiliser dans des automatisations pour des interactions matérielles plus flexibles.(par exemple, déclencher l’entité bouton d’alimentation pour éteindre iHost)Pour plus de détails, consultez le Module complémentaire iHost Hardware Control guide.
Bluetooth
- Modèle de chipset : RTL8723DS
- Chemin : Paramètres > Appareils & Services > Intégrations > Bluetooth
- Découverte : Automatique

Wi-Fi
- Modèle de chipset : RTL8723DS
- Chemin : Paramètres > Système > Réseau > Configurer les interfaces réseau > WLAN0
- Découverte : Automatique

Coordinateur Zigbee
- Modèle de chipset : 00.21.05.0009 SOC EFR32MG21A020F768IM32-B SiliconLabs QFN32-4*4 (RAM 64kB, Flash 768kB)
- Chemin : Paramètres > Système > Matériel > Tout le matériel > /dev/ttyS4
- Découverte : Via Zigbee Home Automation (ZHA) ou Zigbee2MQTT

7. À propos de l’image CoreBox
CoreBox est une nouvelle image HA sur iHost conçue pour une installation rapide, avec la dernière version de HA Core (2025.05.03) pré-intégrée.
Avec CoreBox, vous n’avez plus besoin d’attendre lors de l’installation initiale que l’appareil télécharge HA Core depuis GitHub. Vous pouvez démarrer directement avec la version intégrée de HA Core, atteignant un démarrage en moins de 3 minutes, voire plus rapidement. CoreBox supprime la dépendance à la connexion internet, permettant une installation facile même en mode hors ligne. Vous pouvez toujours mettre à jour vers des versions plus récentes de HA Core depuis le système une fois en fonctionnement.
Pourquoi CoreBox ?
Nous avons écouté attentivement vos retours. De nombreux utilisateurs ont signalé que le processus d’installation original de HA via iHost échouait souvent à cause d’une connexion internet faible ou instable, surtout lors du téléchargement initial de HA Core. Cela causait non seulement de la frustration, mais décourageait aussi beaucoup de nouveaux utilisateurs à continuer.
Même avec notre support en ligne, résoudre les problèmes réseau et suivre le processus d’installation prenait souvent plus de temps que prévu — tant pour les utilisateurs que pour notre équipe.
Nous avons donc créé CoreBox — une solution conçue du point de vue de l’utilisateur.
Avec CoreBox, vous bénéficiez de :
- Une expérience d’installation rapide et fiable
- Plus de retards ni d’installations échouées à cause de problèmes réseau
- Confiance que votre Home Assistant fonctionnera parfaitement — à tout moment, n’importe où
Puis-je mettre à jour le cœur HA intégré ?
Oui ! Une fois que HA démarre avec la version intégrée (2025.5.3), Home Assistant détectera si une version plus récente est disponible. Vous pouvez mettre à jour le cœur de HA comme d'habitude depuis la page Paramètres > Système > Mises à jour — comme pour une installation normale.
9. Extensions prises en charge
-
Maintenant disponible :
-
Extension iHost Hardware Control
Contrôlez les boutons physiques, les indicateurs RVB et les bandes lumineuses directement depuis Home Assistant.
Mappez les entrées matérielles aux automatisations pour une interaction fluide entre les environnements physiques et virtuels.
Vous pouvez cliquer ici pour le tutoriel. -
Extension MG21 Flashing : Mettez à jour le firmware MG21, avec un support optionnel pour flasher les piles Zigbee ou Thread.
Vous pouvez cliquer ici pour le tutoriel. -
Node-Red : Cette extension est une version autonome packagée de Node-RED, conçue exclusivement pour supporter l'architecture linux/arm/v7. Elle a été packagée par SONOFF, spécialement adaptée pour les utilisateurs iHost.
Vous pouvez cliquer ici pour le tutoriel. -
Extension Matter Bridge : Connectez les appareils locaux à l'écosystème Matter pour une intégration multiplateforme.
Vous pouvez cliquer ici pour le tutoriel.
-
10. Remerciements
Ce projet est un développement dérivé basé sur Darkxst’s [ha-operating-system] projet depuis GitHub. Nous remercions sincèrement l'auteur original pour ses contributions fondamentales.




















































3 commentaires
Bertrand
Good project
Mia Ma
回复鄭先生: 会在,HAOS是装在新的SD卡上,不会影响原本的CUBE系统。
鄭先生
請問已安裝CUBE使用一段時間,後來安裝HAOS使用一陣子不習慣
如果切換回CUBE,原本的CUBE資料還會在嗎?
HAOS資料還回在嗎?
想切回CUBE試試看哪個適合我使用,但擔心要重新設定很麻煩很困擾
Laisser un commentaire
Tous les commentaires sont modérés avant d'être publiés.
Ce site est protégé par hCaptcha, et la Politique de confidentialité et les Conditions de service de hCaptcha s’appliquent.