Ce tutoriel vous guidera dans l’installation de Home Assistant sur un mini-PC en 2026, avec une clé Zigbee intégrée pour des commandes automatisées. Vous apprendrez à configurer les sauvegardes et à sécuriser votre accès. À la fin du processus, vous disposerez d’un système domotique complet et personnalisable.

Prérequis

Mini-PC: Un mini-PC comme le Beelink Mini S12 Pro avec un processeur compatible et au moins 4 Go de RAM.
Clé Zigbee: Une clé Zigbee, par exemple la Dresden Elektronik ConBee III, est requise pour connecter les périphériques Zigbee à Home Assistant.
Système d’exploitation: Un système Linux 64-bit installé sur le mini-PC (Ubuntu 23.10 ou Debian 12 recommandés).
Ports réseau: Ouvrir les ports nécessaires pour Home Assistant (généralement le port TCP/8123).
Docker: Docker doit être installé sur votre système.
Domaine personnalisé (optionnel): Si vous souhaitez accéder à Home Assistant via un nom de domaine personnalisé.

Installation pas à pas

Étape 1: Préparation du mini-PC et installation de Docker

Pour commencer, assurez-vous que votre système d’exploitation est mis à jour et que Docker est installé. Sur Debian ou Ubuntu, lancez les commandes suivantes pour mettre à jour le système et installer Docker :

sudo apt update && sudo apt upgrade -y
sudo apt install docker.io -y

Étape 2: Configuration de Home Assistant via Docker

Créez un répertoire pour la configuration de Home Assistant:

mkdir -p /homeassistant/config
chmod a+w /homeassistant/config

Créez ensuite le fichier docker-compose.yml dans ce répertoire :

version: '3'
services:
 home-assistant:
 image: homeassistant/home-assistant:stable
 container_name: home_assistant
 volumes:
 - /homeassistant/config:/config
 networks:
 - hassnet
networks:
 hassnet:

Pour démarrer Home Assistant, exécutez :

cd /homeassistant && docker-compose up -d

Vérifiez que le conteneur Docker est en cours d’exécution avec docker ps.

Étape 3: Intégration de la clé Zigbee ConBee III

Connectez votre clé Zigbee à un port USB du mini-PC. Vous devez installer les dépendances et le driver pour la clé ConBee III:

sudo apt install libusb-dev -y

Puis installez deCONZ, l’outil de gestion des périphériques Zigbee :

git clone https://github.com/dresden-elektronik/deconz-host.git /opt/deconz

Compilez le programme et installez-le:

sudo apt install build-essential -y
cd /opt/deconz && make clean && make
sudo cp deCONZ-daemon/build/src/dresden_elektronik_conbee_daemon /usr/local/bin/conbee-daemon

Modifiez votre fichier docker-compose.yml pour ajouter le volume partagé avec la clé Zigbee:

version: '3'
services:
 home-assistant:
 image: homeassistant/home-assistant:stable
 container_name: home_assistant
 volumes:
 - /homeassistant/config:/config
 - /dev/ttyACM0:/dev/ttyUSB0
 networks:
 - hassnet
networks:
 hassnet:

Redémarrez Home Assistant pour appliquer les changements :

cd /homeassistant && docker-compose up -d --force-recreate

Étape 4: Configuration de la sauvegarde automatique

Pour configurer des sauvegardes automatiques, créez un script bash qui exécute une commande pour sauvegarder le répertoire /homeassistant/config. Par exemple :

#!/bin/bash
tar -czf /home/user/backup_home_assistant_$(date +%Y%m%d_%H%M%S).tar.gz -C /homeassistant config

Enregistrez ce script dans un fichier, par exemple backup.sh, et attribuez-lui les droits d’exécution:

chmod +x backup.sh

Configurez ensuite un cronjob pour exécuter cette sauvegarde de manière régulière. Par exemple, pour une sauvegarde tous les jours à minuit :

crontab -e
0 0 * * * /path/to/backup.sh > /dev/null 2>&1

Étape 5: Configuration de l’accès sécurisé via HTTPS et authentification multi-facteurs (2FA)

Installez Caddy pour fournir un accès web sécurisé à Home Assistant. Ajoutez le service suivant à votre docker-compose.yml:

version: '3'
services:
 home-assistant:
 image: homeassistant/home-assistant:stable
 container_name: home_assistant
 volumes:
 - /homeassistant/config:/config
 - /dev/ttyACM0:/dev/ttyUSB0
 networks:
 - hassnet
 caddy:
 image: caddy
 container_name: caddy_hass
 command: ["run", "--conf=/etc/caddy/Caddyfile"]
 volumes:
 - /homeassistant/config/.caddy:/root/.caddy
 - /etc/localtime:/etc/localtime:ro
 networks:
 - hassnet
networks:
 hassnet:

Créez un fichier Caddyfile pour configurer Caddy avec votre domaine et le service Home Assistant:

yourdomain.com {
 reverse_proxy home_assistant:8123
}

Redémarrez Docker avec la nouvelle configuration:

cd /homeassistant && docker-compose up -d --force-recreate

Étape 6: Configuration de l’authentification multi-facteurs (2FA)

Une fois que Home Assistant est accessible via HTTPS, vous pouvez activer la fonctionnalité d’authentification à deux facteurs. Connectez-vous à votre instance Home Assistant et accédez aux paramètres de sécurité pour configurer 2FA.

Vérifications

Pour vérifier que l’installation a réussi, exécutez les commandes suivantes:

docker ps | grep home_assistant

Vous devriez voir le conteneur Home Assistant en cours d’exécution. Vous pouvez également vérifier la disponibilité de votre instance Home Assistant via un navigateur web à l’adresse HTTPS://yourdomain.com et vous assurer que 2FA est bien activée dans les paramètres.

Sécurité et bonnes pratiques

Pour sécuriser davantage votre installation, assurez-vous d’appliquer les mises à jour régulièrement pour Docker et Home Assistant. Configurez des mots de passe forts pour accéder à l’interface web. Si vous avez un serveur SMTP configuré, configurez également la notification d’événements par e-mail dans les paramètres de Home Assistant.

Dépannage : erreurs courantes

Problème: Le conteneur Docker ne démarre pas.

Cause: Il est possible que le volume partagé soit incorrectement configuré ou manque de permissions.

Correctif: Vérifiez les droits d’accès et la configuration du volume dans docker-compose.yml.

Problème: La clé Zigbee ne fonctionne pas correctement.

Cause: Il peut y avoir un problème avec le driver ou la configuration de la clé.

Correctif: Vérifiez que le driver est bien installé et que les permissions sont correctes pour l’accès à la clé USB.

FAQ

Comment activer la sauvegarde manuelle ?

Pour effectuer une sauvegarde manuelle, exécutez simplement le script de sauvegarde backup.sh que vous avez configuré. Il est recommandé d’exécuter des sauvegardes supplémentaires avant les mises à jour importantes.

Puis-je utiliser un autre protocole que Zigbee ?

Oui, Home Assistant supporte plusieurs protocoles de communication comme Z-Wave ou Bluetooth. La configuration dépendra du matériel utilisé pour ces protocoles.

Que faire si le service Docker ne s’exécute pas automatiquement à la démarrage ?

Vérifiez que l’option Enable service est activée dans les paramètres de Docker et que votre utilisateur a les droits nécessaires sur /var/run/docker.sock. Si nécessaire, ajoutez votre utilisateur au groupe docker avec sudo usermod -aG docker ${USER}.

Comment désinstaller Home Assistant ?

Pour arrêter et supprimer Home Assistant ainsi que toutes ses dépendances, utilisez les commandes suivantes:

docker-compose down --rmi all && rm -rf /homeassistant

Assurez-vous de sauvegarder vos données avant la désinstallation.

A lire aussi

Heberger ce service

Pas envie de gerer le materiel ni la maintenance ? Ce type de service s’auto-heberge sur un VPS manage, pret en quelques minutes. Voir les offres PlanetHoster

Home Assistant sur mini-PC en 2026 : clé Zigbee et sauvegardes

🏆 Notre sélection