Ce document contient les livrables issus de la mise en place du serveur Home Assistant OS. L’objectif est de pouvoir disposer d’une interface de centralisation pour la gestion de la domotique (réception des capteurs, intégration des équipements, automatisation et scénes, etc.).

1.1. Création de la VM

Nous allons utiliser l’image .qcow2 accessible à cette adresse. Sur Proxmox on crée une VM avec ces caractéristiques :

Concernant l’adresse IPv4 sur le segment réseau LAN, il est nécessaire faire une réservation sur l’interface d’administration de la Box du FAI pour pouvoir la conserver. Enfin, pour la configuration IP sur le segment réseau CORE, il est nécessaire d’ajouter une entrée DNS dans la zone du DNS homelab sur le serveur dns-core.homelab.

L’ajout de l’interface vmbr1 sur le segment réseau CORE permet de communiquer avec le serveur acme-core.homelab qui gère la distribution et le renouvellement du certificat wildcard *.ng-hl.com initialement sur les VM du homelab. L’objectif est de profiter du système déjà en place pour gérer le certificat sur le serveur home-assistant.homelab ou home-assistant.ng-hl.com.

Il faut également penser à activer la sauvegarde automatique de la VM sur Proxmox en l’ajoutant au niveau de la politique de sauvegarde créée précédemment dans le projet Homelab - VM-Factory.

2. Installation de Home Assistant OS (via l’image)

La procédure est accessible ici. Voici son contenu :

General:
- Select your VM name and ID
- Select 'start at boot'

OS:
- Select 'Do not use any media'

System:
- Change 'machine' to 'q35'
- Change BIOS to OVMF (UEFI)
- Select the EFI storage (typically local-lvm)
- Uncheck 'Pre-Enroll keys'

Disks:
- Delete the SCSI drive and any other disks

CPU:
- Set minimum 2 cores

Memory:
- Set minimum 4096 MB

Network:
- Leave default unless you have special requirements (static, VLAN, etc)


Confirm and finish. Do not start the VM yet.



Add the image to the VM

- In your node's console, use the following command to import the image from the host to the VM

Bash:

qm importdisk <VM ID> </path/to/file.qcow2> <EFI location>


For example,

Bash:

qm importdisk 205 /home/user/haos_ova-12.0.qcow2 local-lvm



- Close the node's console and select your HA VM

- Go to the 'Hardware' tab

- Select the 'Unused Disk' and click the 'Edit' button

- Check the 'Discard' box if you're using an SSD then click 'Add'

- Select the 'Options' tab

- Select 'Boot Order' and hit 'Edit'

- Check the newly created drive (likely scsi0) and uncheck everything else


Finish Up

- Start the VM

- Check the shell of the VM. If it booted up correctly, you should be greeted with the link to access the Web UI.

- Navigate to <VM IP>:8123

Done. Everything should be up and running now.