/ Docker / Templates Docker / Home assistant

Installer Home Assistant via Docker Compose

Home Assistant est la référence absolue pour la domotique locale. Cette méthode d'installation via Docker Compose permet de maintenir votre configuration propre et de faciliter les mises à jour.

Mode Réseau "Host" : Contrairement à d'autres conteneurs, Home Assistant doit être sur le même réseau que le serveur (mode host) pour détecter automatiquement vos ampoules, prises connectées et enceintes (Google/Alexa).
Sommaire

1. Préparation des dossiers

Créez un dossier pour organiser vos fichiers :

mkdir -p ~/homeassistant
cd ~/homeassistant

2. Le fichier docker-compose.yml

Créez le fichier de configuration :

nano docker-compose.yml

Collez le contenu suivant :

version: '3'

services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - ./config:/config
      - /etc/localtime:/etc/localtime:ro
    environment:
      - TZ=Europe/Paris
    network_mode: host
    restart: unless-stopped
    # privileged: true # Décommentez si vous utilisez une clé USB Zigbee/Zwave

3. Note sur les clés USB (Zigbee/Z-Wave)

Si vous branchez une clé domotique (ex: Conbee II, Sonoff) sur votre serveur, vous devez autoriser le conteneur à y accéder.

Configuration USB : Si vous avez une clé, décommentez la ligne privileged: true dans le fichier ci-dessus, ou ajoutez un mappage de périphérique (devices: - /dev/ttyUSB0:/dev/ttyUSB0) pour plus de sécurité.

4. Lancement et Accès

Démarrez votre domotique :

docker compose up -d

Accédez à l'interface web pour créer votre compte administrateur et commencer la détection des appareils :

http://IP-SERVEUR:8123
Pare-feu : Si vous utilisez un pare-feu (UFW), assurez-vous d'autoriser le port 8123.