🧠 Database & Add-ons Essenziali

::: info Questa pagina descrive la configurazione degli strumenti “vitals” di Home Assistant. L’obiettivo è passare da una configurazione “out-of-the-box” a una configurazione professionale, ottimizzata per le performance e la manutenibilità. :::

1. MariaDB: Ottimizzazione del Database

Home Assistant utilizza il componente recorder per salvare ogni cambio di stato. Di default usa SQLite, ma per un’installazione su Proxmox, MariaDB è la scelta corretta.

Installazione e Configurazione

1. Installa l’Add-on MariaDB dallo Store ufficiale.
2. Nella tab Configuration, imposta una password sicura.
3. Nel file configuration.yaml, configura il recorder per puntare al nuovo database:

# configuration.yaml
recorder:
  db_url: !secret mariadb_url
  purge_keep_days: 7  # Mantieni i log per 7 giorni per non saturare il disco

4. Nel file secrets.yaml, aggiungi la stringa di connessione:

# secrets.yaml
mariadb_url: mysql://homeassistant:TUAPASSWORD@core-mariadb/homeassistant?charset=utf8mb4

2. File Editor & Studio Code Server

Per modificare i file di configurazione (.yaml), hai bisogno di un editor integrato.

• File Editor: Leggero, semplice, ideale per modifiche rapide via browser.
• Studio Code Server (VS Code): Basato su Visual Studio Code. È lo strumento preferito dai programmatori perché offre auto-completamento, controllo sintattico e terminale integrato.
  • Consiglio: Se la tua VM ha almeno 4GB di RAM, usa Studio Code Server.

3. Samba Share: Accesso al Filesystem via Rete

Fondamentale per gestire i file (es. caricare lo script Python vsc_sync.py o file audio/immagini) direttamente dal tuo PC principale.

1. Installa l’Add-on Samba share.
2. Configura username e password.
3. Da Windows (Explorer) o macOS (Finder), connettiti a \\IP_HOME_ASSISTANT\config.

4. Google Drive Backup (Off-site Protection)

Come discusso nella strategia di backup, questo add-on automatizza l’invio dei backup interni sul Cloud.

• Funzionamento: Crea un backup locale -> Lo carica su Google Drive -> Elimina i vecchi backup locali per risparmiare spazio.

📉 Flusso Dati del Recorder (Mermaid)

graph LR
    SUB[Sensori/Dispositivi] -->|Stato| HA[Home Assistant Core]
    HA -->|Write Query| REC[Recorder Component]
    REC -->|TCP/3306| MDB[(MariaDB Engine)]
    MDB -->|Query| DASH[Dashboard History Graph]

💡 Note dell’Ingegnere (Critical Thinking)

• I/O Wait: SQLite scrive su un file che viene bloccato (file locking) a ogni scrittura. MariaDB gestisce le connessioni in modo concorrente, riducendo il carico sulla CPU della VM.
• Log Purging: È inutile tenere mesi di dati nel database del recorder (che serve per i grafici a breve termine). Per l’analisi a lungo termine (statistiche annuali), Home Assistant usa le “Long Term Statistics” che sono già ottimizzate. Impostare purge_keep_days: 7 mantiene il database snello e veloce.
• Secrets Management: Non scrivere mai le password direttamente in configuration.yaml. Usa sempre il file secrets.yaml per mantenere la separazione tra logica e credenziali.

Ultimo aggiornamento: {{UPDATE_DATE}} | Tags: #MariaDB #Database #Performance #Addons #Samba