Solution communautaire

Exécuter Home Assistant OS dans le ZVM de ZimaOS : QCOW2, UEFI et paramètres de la VM

An April–May 2026 ZVM thread where Home Assistant OS appeared stuck when created from a VDI with BIOS firmware. Multiple community users reported better results with QCOW2 plus UEFI, matching Home Assistant's current KVM guidance.

Exécuter Home Assistant Container depuis l’App Store de ZimaOS n’est pas la même chose qu’exécuter Home Assistant OS. Le conteneur fournit Home Assistant Core dans Docker, tandis que HAOS est une image d’appliance complète avec des modules complémentaires gérés par Supervisor et son propre environnement d’exploitation. L’auteur du message d’origine souhaitait bénéficier de l’expérience HAOS complète, car certaines intégrations Tuya et Xiaomi fonctionnaient mal pour lui dans le déploiement en conteneur.

Sa première tentative avec ZVM n’a jamais dépassé l’écran de chargement, même après avoir été laissée toute la nuit. Le fil de discussion n’a pas établi que ZVM était incapable d’exécuter HAOS. Au contraire, des réponses ultérieures ont identifié deux choix de configuration à modifier en premier : l’utilisateur avait sélectionné une image disque VirtualBox .vdi et un firmware BIOS hérité.

À quoi ressemblait la configuration ZVM d’origine

Configuration ZVM de ZimaOS utilisant une image VDI de Home Assistant, un disque de 64 Go, 4 Go de RAM, un réseau en pont et un firmware BIOS
La machine virtuelle d’origine utilisait un disque VDI et un firmware BIOS. Les réponses ultérieures se sont concentrées sur ces deux paramètres avant de suggérer des modifications plus importantes.
Console de machine virtuelle ZimaOS pour Home Assistant OS bloquée sur un indicateur de chargement
Dans la configuration d’origine, la machine virtuelle n’est pas allée au-delà de cette étape.

Privilégier l’image QCOW2 pour un hyperviseur de type KVM

Un membre de la communauté qui avait exécuté Home Assistant OS dans ZVM pendant environ deux mois a indiqué utiliser l’image QCOW2. Cette recommandation correspond à la page actuelle de téléchargement des machines virtuelles de Home Assistant, qui propose QCOW2 pour les hyperviseurs de type KVM/Proxmox.

Pour un nouveau déploiement ZVM, commencez par l’image actuelle de Home Assistant OS destinée aux machines virtuelles de type KVM. Une image VDI est principalement associée à VirtualBox et n’est pas le choix initial le plus naturel pour ZVM.

Utiliser le firmware UEFI

La machine virtuelle d’origine utilisait le BIOS. Deux réponses distinctes de la communauté ont suggéré de passer à l’UEFI, et les recommandations actuelles de Home Assistant exigent l’UEFI pour les machines virtuelles HAOS.

Paramètres ZVM ZimaOS validés par la communauté pour Home Assistant OS, avec QCOW2, 2 Go de RAM, réseau en pont et firmware UEFI
Un utilisateur ayant exécuté HAOS dans ZVM a partagé cette configuration QCOW2 et UEFI comme référence fonctionnelle connue.

Ne pas surdimensionner la machine virtuelle avant d’avoir résolu la compatibilité au démarrage

La machine virtuelle d’origine disposait d’un disque virtuel de 64 Go et de 4 Go de RAM. Un autre utilisateur a indiqué utiliser un disque de 32 Go, dont environ la moitié de l’espace était encore libre, et un résumé de la communauté suggérait de commencer avec environ 2 vCPU, 2 à 4 Go de RAM et un disque de 32 Go.

Davantage de CPU, de RAM ou de stockage ne résoudra pas un problème de firmware ou de format d’image. Résolvez d’abord le chemin de démarrage, puis augmentez les ressources en fonction des modules complémentaires, de la durée de conservation de l’historique, des bases de données et des intégrations réellement utilisés.

Laisser le premier démarrage s’initialiser

Une réponse indiquait que HAOS pouvait rester sur une console noire ou silencieuse pendant plusieurs minutes, le temps d’étendre le stockage et d’initialiser les services. Cela diffère du fait de laisser le même état de chargement toute une nuit. Après être passé à une image compatible et à l’UEFI, laissez suffisamment de temps au premier démarrage avant de conclure que le système est bloqué.

L’incompatibilité de VDI n’a pas été démontrée

La correction la plus importante à la conclusion simpliste selon laquelle « VDI ne fonctionne pas » est venue plus tard dans le fil : un autre utilisateur de ZimaBoard 2 a indiqué que Home Assistant OS 17.3 au format VDI fonctionnait chez lui lorsque la machine virtuelle utilisait l’UEFI. Le format d’image seul n’a donc pas été établi comme cause principale.

La conclusion la plus exacte est que QCOW2 avec UEFI constitue la configuration initiale la plus sûre, car elle correspond à la famille d’hyperviseurs visée et à un déploiement ZVM connu comme fonctionnel. L’UEFI semble être l’exigence la plus importante.

Quand le conteneur Home Assistant de ZimaOS suffit

Page de l’App Store de ZimaOS consacrée à l’application conteneur Home Assistant
La version de l’App Store est plus facile à déployer, mais elle ne fournit pas le modèle complet Supervisor et modules complémentaires de HAOS.

Si les intégrations nécessaires fonctionnent dans Home Assistant Container, cette solution est plus légère et évite d’exécuter un second système d’exploitation dans une machine virtuelle. Si vous avez spécifiquement besoin des modules complémentaires de HAOS ou de son modèle de gestion de type appliance, ZVM peut convenir, mais ajoute également une couche de virtualisation qui doit rester fonctionnelle lors des mises à jour de ZimaOS.

Un hyperviseur distinct constitue une autre architecture

Un participant a suggéré d’installer Proxmox sur la machine physique N150 et d’exécuter ZimaOS et Home Assistant OS dans des machines virtuelles distinctes. Cela peut isoler Home Assistant de la maintenance de ZimaOS, mais modifie toute l’architecture de l’hôte et ne doit pas être présenté comme nécessaire pour résoudre le problème de ce fil.

Ordre de dépannage pratique

  1. Téléchargez l’image actuelle de machine virtuelle HAOS plutôt que de réutiliser un ancien fichier.
  2. Commencez avec QCOW2 si ZVM l’accepte.
  3. Sélectionnez le firmware UEFI.
  4. Attribuez des ressources raisonnables, par exemple 2 vCPU, 2 à 4 Go de RAM et environ 32 Go de disque.
  5. Utilisez un mode réseau qui fournit à la machine virtuelle HAOS une adresse utilisable sur le réseau local.
  6. Laissez suffisamment de temps au premier démarrage pour l’initialisation.
  7. Si la machine virtuelle ne démarre toujours pas, inspectez la console avant de modifier les paramètres de stockage ou de l’application.

FAQ sur Home Assistant OS dans ZVM

Quelle image dois-je essayer en premier ?

QCOW2 est le meilleur premier choix, car il est destiné aux hyperviseurs de type KVM et a fonctionné dans un déploiement ZVM de la communauté.

ZVM doit-il utiliser le BIOS ou l’UEFI pour HAOS ?

Utilisez l’UEFI. Les exigences actuelles de Home Assistant demandent explicitement l’UEFI.

HAOS a-t-il besoin d’un disque virtuel de 64 Go ?

Pas pour une installation de base. Des utilisateurs de la communauté ont indiqué que 32 Go fonctionnaient confortablement, même si un historique volumineux ou des modules complémentaires peuvent justifier davantage d’espace.

La prise en charge de VDI a-t-elle été officiellement exclue ?

Non. Un utilisateur de ZimaBoard 2 a ensuite signalé qu’un déploiement VDI avec UEFI fonctionnait.