Da Home Assistant Supervisor a Docker: guida completa

Se stai cercando un modo per alleggerire il tuo sistema smart home e ottenere maggiore libertà di gestione, spostare Home Assistant in ambiente Docker è la soluzione ideale . In questa guida vedremo tutti i passaggi necessari per trasferire la tua configurazione esistente e sfruttare al massimo i vantaggi dei container.

Perché scegliere Docker?

• Fine del vecchio add-on manager
  L’add-on manager integrato sta per essere ritirato, ed è il momento giusto per adottare un approccio modulare e più stabile.

• Maggiore autonomia
  Con Docker separi Home Assistant Core e ogni servizio accessorio in container indipendenti, evitando dipendenze nascoste.

• Scalabilità garantita
  Ospita diversi microservizi sullo stesso hardware senza conflitti di versione o risorse.

Cosa ti serve

1. Un server o un mini-PC (ad es. Raspberry Pi OS, Ubuntu o Debian) con Docker e Docker Compose installati.

2. Privilegi di amministratore sull’installazione corrente di Home Assistant Supervisor.

3. Un backup aggiornato della tua configurazione, add-on inclusi.

4. Conoscenze di base della shell e dei file YAML di Compose.

Procedura dettagliata

1. Preparare il backup

1. Disattiva eventuali cifrature sui backup per facilitarne la decompressione.

2. Genera un salvataggio completo da Impostazioni → Sistema → Backup e scaricalo in una cartella sicura.

3. Segui la guida ufficiale di Docker Compose per rendere il tuo host pronto all’uso.

2. Organizzare le directory

Crea una struttura ordinata, ad esempio sotto /opt/homeassistant:

sudo mkdir -p /opt/homeassistant/{config,zigbee2mqtt,mosquitto/{data,conf}}

3. Spegnere l’add-on manager

Prima di procedere, annota il nome degli add-on che stai usando (es. mosquitto, zigbee2mqtt).

sudo ha core stop
sudo systemctl disable hassio-supervisor
sudo systemctl stop hassio-supervisor

4. Trasferire i dati

• Zigbee2MQTT

  sudo cp -r /usr/share/hassio/addons/data//* /opt/homeassistant/zigbee2mqtt/

• Mosquitto
  Prepara il file

  /opt/homeassistant/mosquitto/conf/mosquitto.conf

  con:

  persistence true
  persistence_location /mosquitto/data/
  log_dest file /mosquitto/data/mosquitto.log
  allow_anonymous true
  listener 1883
  

Poi copia i dati:

sudo cp -r /usr/share/hassio/addons/data/core_mosquitto/* /opt/homeassistant/mosquitto/data/

Home Assistant Core

sudo cp -r /usr/share/hassio/homeassistant/* /opt/homeassistant/config/

5. Creare il file docker-compose.yml

 
version: '3.8'
services:
  homeassistant:
    image: ghcr.io/home-assistant/home-assistant:stable
    container_name: home-assistant
    volumes:
      - /opt/homeassistant/config:/config
      - /etc/localtime:/etc/localtime:ro
    ports:
      - 8123:8123
    restart: unless-stopped

  mosquitto:
    image: eclipse-mosquitto:latest
    container_name: mqtt
    volumes:
      - /opt/homeassistant/mosquitto/data:/mosquitto/data
      - /opt/homeassistant/mosquitto/conf:/mosquitto/config
    ports:
      - 1883:1883
    restart: unless-stopped

  zigbee2mqtt:
    image: koenkk/zigbee2mqtt:latest
    container_name: zigbee2mqtt
    volumes:
      - /opt/homeassistant/zigbee2mqtt:/app/data
    devices:
      - /dev/ttyACM0:/dev/ttyACM0
    restart: unless-stopped

Ecco un esempio base da adattare:

Assicurati di inserire la tua zona oraria e gli eventuali parametri aggiuntivi per ogni servizio .

6. Avviare automaticamente

Crea un’unità systemd in /etc/systemd/system/homeassistant.service:

[Unit]
Description=Avvio Home Assistant su Docker
After=docker.service
Requires=docker.service

[Service]
WorkingDirectory=/opt/homeassistant
ExecStart=/usr/local/bin/docker-compose up -d
ExecStop=/usr/local/bin/docker-compose down
Restart=always

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable homeassistant
sudo systemctl start homeassistant

Cosa dovrai gestire diversamente

• Aggiornamenti manuali: segui i rilasci sul repository ufficiale o crea script di monitoraggio.

• Interfacce degli add-on: usa un reverse proxy (ad esempio Nginx) per esporre i pannelli web.

• Backup personalizzati: integra tool come rclone per inviare copie su cloud (Google Drive, Nextcloud…).