Installer Home Assistant sur Proxmox

Contexte

Les chapitres précédents ont posé l’épine dorsale MQTT de la maison : Mosquitto comme broker (chapitres 7-8), et zigbee2mqtt comme pont entre le réseau Zigbee et le bus de messages (chapitre 10). Les capteurs et actionneurs Zigbee publient déjà leurs événements sur des topics MQTT et peuvent recevoir des commandes.

Reste à mettre en place l’unité de traitement qui orchestre tout ça : Home Assistant. C’est lui qui va s’abonner aux topics MQTT, exposer les appareils dans une interface lisible, déclencher des automatisations (« si la porte s’ouvre après 22 h alors allume la lumière »), historiser les valeurs et fournir des tableaux de bord.

Cet article décrit comment l’installer en VM sur Proxmox, la solution que j’utilise. Le prochain raccordera concrètement les appareils Zigbee à Home Assistant via MQTT Discovery.

Pourquoi en VM sur Proxmox

Home Assistant peut s’installer de plusieurs manières. Depuis 2025, le projet officiel ne supporte plus que deux méthodes (HAOS et Container) ; les autres sont dépréciées. Parmi les options HAOS, on a le choix entre :

• HAOS sur Raspberry Pi dédié — une machine, un rôle. Simple, mais immobilise un Pi et une carte SD/SSD pour une seule application.
• HAOS dans une VM — sur un hyperviseur (Proxmox, ESXi, KVM…) qui mutualise plusieurs services sur la même machine.

Pour qui a déjà un hôte Proxmox dans la maison, la voie VM s’impose pour plusieurs raisons :

Mutualisation des ressources — Home Assistant est l’un des nombreux services qui tournent sur la même lame. Mes autres VM cohabitent sans difficulté avec HA, ce qui évite d’empiler les SBC alimentés en permanence.

Snapshots Proxmox — avant chaque mise à jour majeure de HA ou test d’un nouvel add-on, un snapshot pris en 5 secondes permet de revenir en arrière instantanément si quelque chose casse. C’est un confort indissociable de l’usage qu’on en fait.

Sauvegardes Proxmox Backup Server — la VM entière est sauvegardée selon la politique du PBS, en plus des sauvegardes internes à HA. Double filet de sécurité.

Indépendance du matériel — la VM peut migrer d’un nœud Proxmox à un autre sans rien casser, et un changement de serveur physique n’impose pas de réinstaller HA depuis zéro.

Réplication ZFS — si le pool Proxmox tourne sur ZFS, on peut répliquer la VM HA sur un second nœud en quelques clics.

Le seul cas où je conseillerais HAOS sur Pi dédié, c’est sans Proxmox sous la main et sans envie d’en monter un — ce qui ne s’applique pas ici puisque l’infrastructure Proxmox est déjà présente (voir les articles précédents sur le cluster Proxmox et l’incident acegrp.lan).

Le compteur électrique téléinfo, lui, reste sur son propre Raspberry Pi dédié (avec raspjson + relais MQTT). On ne mélange pas la collecte téléinfo et HA sur la même machine : un démon qui tourne en temps réel sur un port série a des contraintes différentes d’une VM domotique, et la téléinfo a besoin du GPIO physique du Pi que la VM ne verrait pas.

Méthode 1 — Le script communautaire (recommandé)

L’écosystème Proxmox a hérité des helper scripts créés à l’origine par tteck, repris depuis sa disparition fin 2024 par l’organisation community-scripts/ProxmoxVE. Ces scripts automatisent en une commande la création d’une VM, le téléchargement de l’image HAOS la plus récente, l’import du disque, la configuration réseau, et le démarrage.

Depuis la Shell du nœud Proxmox (interface web → nœud → bouton « Shell » en haut à droite, ou SSH direct), exécuter :

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/vm/haos-vm.sh)"

Le script ouvre un assistant TUI (interface texte). Les choix proposés :

1. Mode : Default convient pour 95 % des cas (CPU host, vCPU 2, RAM 2 Go, disque 32 Go, bridge vmbr0, DHCP). Advanced permet de tout ajuster.
2. Disk storage : pool ZFS ou LVM où créer le disque virtuel.
3. VM ID : identifiant unique (Proxmox propose automatiquement un libre).
4. Hostname : nom de la VM dans Proxmox.
5. Confirmation finale.

Le téléchargement de l’image .qcow2.xz officielle, sa décompression, l’import dans Proxmox et la création de la VM prennent quelques minutes selon la connexion. À la fin, la VM démarre automatiquement.

⚠️ Lire le script avant de l’exécuter. C’est une bonne pratique générale avec les curl | bash : on télécharge et on parcourt le code avant de le passer à bash. Le dépôt community-scripts/ProxmoxVE est bien suivi et largement utilisé, mais le principe reste valable.

Vérifier que la VM tourne

Dans l’interface Proxmox, la nouvelle VM apparaît. Sa console (onglet Console) affiche le boot HAOS, puis l’écran d’accueil :

Home Assistant OS 17.3
Home Assistant Core 2026.5.1

IPv4 addresses for enp0s18: 192.168.100.16/24

Home Assistant URL:  http://homeassistant.local:8123
Observer URL:        http://homeassistant.local:4357

System is ready! Use browser or app to configure.

L’IP affichée vient du DHCP du réseau. Ouvrir un navigateur sur http://homeassistant.local:8123 (résolution mDNS) ou directement sur l’IP affichée.

Méthode 2 — Installation manuelle

Si le script ne convient pas (besoin de réglages spécifiques, environnement contraint, envie de comprendre ce qui se passe), on peut tout faire à la main. La procédure suit le guide officiel de la communauté Home Assistant.

Étape 1 — Récupérer l’image

Depuis la Shell Proxmox :

cd /var/lib/vz/template/iso/
wget https://github.com/home-assistant/operating-system/releases/latest/download/haos_ova-17.3.qcow2.xz
unxz haos_ova-17.3.qcow2.xz

Vérifier la version la plus récente sur github.com/home-assistant/operating-system/releases — le numéro change régulièrement.

Étape 2 — Créer la VM dans l’interface Proxmox

Create VM, avec les réglages suivants :

Confirmer mais ne pas démarrer la VM.

Étape 3 — Importer le disque HAOS

Noter l’ID de la VM créée (par exemple 100), puis dans la Shell Proxmox :

qm importdisk 100 /var/lib/vz/template/iso/haos_ova-17.3.qcow2 local-lvm

Remplacer local-lvm par le stockage cible (ex. local-zfs si pool ZFS).

Étape 4 — Attacher et booter

Dans l’interface Proxmox, sur la VM :

1. Hardware → double-cliquer sur Unused Disk 0 → Bus SCSI → Add.
2. Options → Boot Order → cocher le disque SCSI nouvellement attaché, le faire glisser en première position.
3. Démarrer la VM.

L’écran d’accueil HAOS apparaît dans la console.

Configuration réseau recommandée

Que la VM ait été créée par script ou manuellement, elle obtient une IP par DHCP. Pour qu’elle reste joignable durablement à la même adresse :

Option A — Réservation DHCP côté routeur (ma préférence). On note l’adresse MAC de la VM (interface Proxmox → Hardware → carte réseau), et on crée une réservation dans le DHCP du routeur. La VM garde son IP même après reboot ou recréation.

Option B — IP statique côté HAOS. Depuis la console de la VM, taper login (compte root, sans mot de passe sur la console locale), puis network update et suivre l’assistant. Moins flexible et oublié facilement lors d’une migration de réseau.

Onboarding Home Assistant

Au premier accès à http://homeassistant.local:8123 (ou l’IP), HA propose une procédure d’accueil :

1. Création du compte propriétaire (admin local) — utiliser un mot de passe long, ce compte a tous les pouvoirs sur l’installation.
2. Informations sur la maison — nom, fuseau horaire, monnaie, unités. Détectés automatiquement par géolocalisation IP, à ajuster si nécessaire.
3. Découverte des appareils — HA détecte automatiquement les appareils compatibles sur le réseau local (Chromecast, imprimantes, etc.). On peut sauter cette étape et y revenir plus tard.

À la fin de l’onboarding, on arrive sur le tableau de bord par défaut. L’installation est fonctionnelle.

Connecter Home Assistant au broker MQTT

C’est l’étape qui fait le lien entre HA et l’écosystème MQTT mis en place dans les chapitres précédents. Deux scénarios :

Scénario A — Mosquitto installé séparément (le cas de ce livre)

Mosquitto tourne déjà sur une autre machine (le Raspberry Pi de la téléinfo, ou un LXC Proxmox dédié). On configure simplement l’intégration MQTT côté HA :

1. Paramètres → Appareils & services → Ajouter une intégration → chercher MQTT.

2. Saisir les coordonnées du broker :

   • Broker : adresse IP du serveur Mosquitto (ex. 192.168.100.50)
   • Port : 1883
   • Identifiant / mot de passe : ceux configurés dans Mosquitto

3. Valider. HA teste la connexion et l’intégration apparaît dans la liste.

Scénario B — Mosquitto comme add-on HAOS

Si l’on part d’une installation HA fraîche sans Mosquitto déjà déployé, le projet propose un add-on Mosquitto officiel :

1. Paramètres → Modules complémentaires → Boutique → chercher Mosquitto broker → Installer → Démarrer.
2. L’add-on utilise le système d’authentification des utilisateurs HA. Créer dans HA un utilisateur dédié (par exemple mqtt-user).
3. Configurer l’intégration MQTT comme dans le scénario A, mais avec core-mosquitto comme broker.

⚠️ Ne pas faire les deux. Si Mosquitto tourne déjà ailleurs, on garde celui-là — pas besoin de dupliquer le broker.

Vérification

Une fois MQTT configuré, depuis n’importe quelle machine du réseau :

mosquitto_pub -h <ip-broker> -t 'test/ping' -m 'hello-ha' -u <user> -P <pass>

Côté HA : Paramètres → Appareils & services → MQTT → Configurer → Écouter un topic → saisir test/ping → on doit voir arriver le message.

À ce stade, HA peut entendre tout ce qui passe sur le broker — y compris les trames téléinfo publiées par le relais (chapitre 25), et les événements Zigbee publiés par zigbee2mqtt. Reste à les rendre visibles dans l’interface, ce qui passe par le mécanisme de découverte automatique MQTT détaillé dans le chapitre suivant.

Sauvegardes

Sur HAOS, deux niveaux de sauvegarde coexistent et se complètent.

Sauvegardes internes HAOS : Paramètres → Système → Sauvegardes → activer une sauvegarde quotidienne. Contient le Core, les add-ons, leur configuration et leurs données. Plusieurs add-ons permettent ensuite de pousser ces sauvegardes hors du Pi (Samba, Nextcloud, Google Drive).

Sauvegardes Proxmox : la VM entière est sauvegardée par PBS (ou par le vzdump intégré). Restauration possible sur n’importe quel hôte Proxmox compatible.

Ces deux niveaux ne se substituent pas : une sauvegarde HAOS est plus fine et plus rapide à restaurer (un seul add-on, par exemple), tandis qu’une sauvegarde Proxmox protège contre la corruption complète de la VM ou du stockage.

Snapshots avant chaque opération risquée

L’usage qui change la vie sur Proxmox : avant toute opération potentiellement risquée (mise à jour majeure de HA, installation d’un nouvel add-on en bêta, modification importante de la configuration), prendre un snapshot.

Interface Proxmox → VM → onglet Snapshots → Take Snapshot → nommer (par exemple avant-update-2026.5). En cas de problème, Rollback ramène la VM à l’état exact d’avant l’opération en quelques secondes, sans rejouer une sauvegarde longue.

Les snapshots consomment de l’espace disque proportionnel aux changements écrits depuis leur création — il faut donc les purger régulièrement, pas les accumuler indéfiniment.

Suite

Home Assistant est installé, joignable, connecté au broker MQTT. Il entend ce qui se passe sur le bus mais n’a pas encore d’appareils visibles dans son interface.

Le chapitre suivant montre comment faire apparaître automatiquement les appareils Zigbee publiés par zigbee2mqtt, via le mécanisme MQTT Discovery — c’est l’astuce qui transforme un broker MQTT brut en plateforme domotique exploitable.