Guide d'installation de Home Assistant avec Docker

Pourquoi utiliser Docker pour Home Assistant ?

• Isolation : Docker exécute Home Assistant dans un conteneur isolé, réduisant les risques d'interférences avec d'autres applications.
• Simplicité : Installation rapide et gestion simplifiée des mises à jour.
• Portabilité : Facile à déplacer ou recréer sur une autre machine.

Pré-requis

1. Machine supportée :
   • PC, serveur ou NAS fonctionnant sous Linux, macOS, ou Windows avec Docker installé.
2. Docker installé : Téléchargez et installez Docker depuis docker.com.
   • Pour Linux :

     sudo apt-get update
     sudo apt-get install docker.io

   • Pour macOS/Windows : Installez Docker Desktop.
3. Accès administrateur/root : Nécessaire pour exécuter les commandes Docker.

Étapes pour installer Home Assistant avec Docker

1. Préparer l'environnement

Créez un répertoire pour stocker les fichiers de configuration :

mkdir -p ~/homeassistant

Accédez au répertoire :

cd ~/homeassistant

2. Créer le fichier docker-compose.yml

Dans le dossier homeassistant, créez un fichier docker-compose.yml avec le contenu suivant :

services:
  homeassistant:
    image: ghcr.io/home-assistant/home-assistant:stable
    container_name: homeassistant
    environment:
      - TZ=Europe/Paris  # Remplacez par votre fuseau horaire
    volumes:
      - ./config:/config  # Stockage persistant des données
    ports:
      - "8123:8123"  # Port d'accès à l'interface web
    restart: unless-stopped
            

3. Lancer Home Assistant

Dans le répertoire homeassistant, exécutez :

docker-compose up -d

Pour vérifier que le conteneur fonctionne :

docker ps

4. Accéder à Home Assistant

Ouvrez un navigateur web et accédez à :

http://localhost:8123

Ou utilisez l'adresse IP de votre machine :

http://<adresse_IP>:8123

Configurer Windows Defender pour autoriser Home Assistant

Pour accéder à Home Assistant sur Windows, il est nécessaire de créer une règle dans Windows Defender pour autoriser le port 8123 :

1. Ouvrez le menu **Démarrer** et recherchez **Pare-feu Windows Defender avec fonctions avancées de sécurité**.
2. Cliquez sur **Règles de trafic entrant** dans le panneau de gauche.
3. Dans le panneau de droite, cliquez sur **Nouvelle règle**.
4. Sélectionnez **Port**, puis cliquez sur **Suivant**.
5. Saisissez **8123** dans le champ des ports spécifiques.
6. Choisissez **Autoriser la connexion** et cliquez sur **Suivant**.
7. Cochez les options **Domaine**, **Privé** et **Public**, puis cliquez sur **Suivant**.
8. Donnez un nom à la règle (ex. : Home Assistant) et cliquez sur **Terminer**.

Une fois cette règle créée, le port 8123 sera accessible, et vous pourrez vous connecter à Home Assistant.

Conseils pour connecter des robinets thermostatiques

Si vous n’avez pas de boîtier TaHoma, voici d’autres solutions :

• Zigbee : Utilisez un dongle ConBee II ou un hub compatible.
• Z-Wave : Utilisez un Aeotec Z-Stick ou Fibaro Home Center.
• Wi-Fi : Connectez directement les appareils à votre réseau.
• Logiciels recommandés : Home Assistant, Jeedom ou Domoticz.

Pour TaHoma:

1. Activez le mode développeur dans l'application ou l'interface web TaHoma.
2. Ajoutez l’intégration TaHoma dans Home Assistant.
3. Configurez vos identifiants TaHoma dans Home Assistant.
4. Home Assistant détectera automatiquement vos appareils connectés via TaHoma.

Mise à jour et gestion

Pour mettre à jour Home Assistant :

docker-compose down
docker-compose pull
docker-compose up -d
            

Pour consulter les logs :

docker logs homeassistant