Migration HAOS vers Home Assistant Docker

Home Assistant - Tutoriels & Partages Autres
1

J’ai débuté sur Home Assistant OS (HAOS) puis j’ai migré vers la solution Home Assistant Docker pour pouvoir exploiter la pleine puissance de mon raspberry Pi 5.
Ayant atteint un niveau de complétude satisfaisant, je souhaite partager avec vous le fruit de mon travail. L’objectif n’est pas de débattre sur ce qui est bien ou pas bien, seulement de regrouper en un seul endroit une solution compléte.

Pour installer Home Assistant disons qu’il y a 3 types d’installation :

  1. Home Assistant vers HAOS
    Home Assistant installé via son propre système d’exploitation
    Avantage : Solution all-inclusive, facile a déployer, compléte, ergonomique, bref du bon boulot de la part de Nabu Casa.
    Inconvénient : Le système est un peu fermé et on ne peut pas faire plusieurs choses en meme temps avec son Raspberry comme l’utiliser en tant qu’ordinateur de bureau.

  2. Home Assistant version HAOS installé sur machine virtuelle
    Une machine virtuelle type Proxmox permet de faire croire à HAOS et tout seul.
    [Article] Installer Home Assistant OS avec Proxmox (VM)
    Avantage : On profite de toute la puissance de HAOS tout en pouvant faire autre chose de son Raspberry en même temps comme un ordinateur de bureau.
    Inconvénient : Je ne sais pas, je l’ai pas fait :stuck_out_tongue:

  3. Home Assistant version Docker
    Home Assistant core tourne dans un conteneur type docker (un peu comme fait HAOS) sauf qu’on garde la main sur le système d’exploitation.
    Avantage : On fait faire a peu prés tout se que l’on veut avec son Raspberry
    Inconvénient : Rien n’est intégré, il faut tout gérer soit même. Pour ceux qui veulent découvrir linux c’est un bon exercice ^^

Donc vous l’aurez compris, je m’interesse à la migraration de 1 vers 3 en conservant l’intégralité de mes automatisations et fonctionnalités initiales mais je ne vais pas forcément faire la publicité pour ce choix.

Situation de départ :
Raspberry Pi 5 avec Dongle Zigbee Sononf 3.0+ et carte SSD.
Installation de Home Assistant OS (aujourd’hui 2025.12.3) avec les add-ons suivants :
MQTT Mosquitto, Zigbee2MQTT, Let’sEncrypt, DuckDNS, FileEditor et Backup to Google Drive

Situation d’arrivée :
Raspberry Pi 5 avec Carte d’extension bottom M2 Seeed Studio + Disque NVMe + ventilateur Ice Tower cooler+ et dongle Zigbee Sononf 3.0+
Systeme d’exploitation : Debian bookworm 12.12 + docker (1.52)
Logiciels : Portainer, DuckDns, LetEncrypt, Mosquitto MQTT, Zigbee2MQTT, Watchtower, MQTT Explorer (falcutatif)
Avec pas mal de sueur, patience et huile de coude, on arrive a obtenir un environnement équivalent (sauf qu’on ne peut pas rebooter le raspberry depuis Home Assistant ^^)

Je vais découper mon tuto en plein de message séparé pour plus de clartée, c’est parti!

2

Etape 1 : Réaliser ses backup sous Home Asisstant

Je vous recommande vivement d’installer l’add-on Backup Google Drive pour enregistrer votre backup sur le cloud, surtout si votre HAOS tourne sur SSD. Les cartes SSD ne sont pas réputées pour leur fiabilité.
Suivez ce tuto très bien fait :

Lancer un Full Backup en incluant les adds-ons puis garder sur le cloud dans un endroit precis cette sauvegarde + Télécharger le kit de secours!
NB: Si vous utilisez Zigbee2Mqtt, les identifiants des appareils linkés seront enregistrés dans le Full Backup.

3

Etape 2: Configurer sa box Router

under construction

5

Etape 3 : Installer Let’s Encrypt

On démarre dans le dur, pour moi c’est l’étape la plus compliquée.

Lets Encrypt permet d’obtenir des certificats SSL/TLS afin d’utiliser Home Assistant en https.

A savoir: si Home Assistant est configuré en Https, toutes les integrations dans l’interface graphique via des Iframes doivent être en https également.

Lets Encrypt s’installe a travers Certbot

Mais avant cela, il faut installer un petit serveur web : NGinx
Tuto très facile à suivre :

Dans une console taper les instructions suivantes :

sudo apt update -y
sudo apt install nginx -y
sudo systemctl enable nginx

Ensuite, pour installer Certbot, je propose de suivre les instructions pour Nginx et Linux PIP.

Sources :

Installer python :

sudo apt install python3 python3-dev python3-venv libaugeas-dev gcc

Creer un environnement python

sudo python3 -m venv /opt/certbot/
sudo /opt/certbot/bin/pip install --upgrade pip

Installer Certbot

sudo /opt/certbot/bin/pip install certbot certbot-nginx

Creer un lien symbolique pour garantir que Certbot sera accessible partout

sudo ln -s /opt/certbot/bin/certbot /usr/bin/certbot

Laisser Certbot configurer NGinx pour activer le https:

sudo certbot --nginx

Ajouter une plannification de tache pour renouveler les certificats (tous le 1er du mois à minuit):

echo "0 0 1 * * root /opt/certbot/bin/python -c 'import random; import time; time.sleep(random.random() * 3600)' && sudo certbot renew -q" | sudo tee -a /etc/crontab > /dev/null

Commande à lancer tous les mois pour verifier que certbot est à jour :

sudo /opt/certbot/bin/python3 -m pip install --upgrade pip
6

Etape : Installation de Docker

Under construction

7

Etape : Installation de Portainer

Under construction

8

Etape : Installation de Duckdns

Under construction

9

Etape : Installation de Mosquitto MQTT

Under construction

10

Etape : Installation de Home Assistant

Under construction

11

Etape : Installation de File Editor aussi appelé HAAS configurator

Under construction

12

Etape : Installation de Zigbee2MQTT

Etape suivante.
Under construction

13

Etape : Installation de MQTT Explorer [falcutatif]

Petite reorganisation
Under construction

14

Merci de ne rien poster tant que je n’ai pas fini :slight_smile: :laughing:

1 « J'aime »