🔧 Setup VM Home Assistant su Proxmox

::: info L’installazione in modalità VM (Virtual Machine) è il metodo raccomandato per istanze di produzione. Permette l’utilizzo di “Home Assistant Supervisor”, garantendo aggiornamenti semplificati, backup del sistema intero e gestione facilitata dei driver hardware. :::

1. Decision Making: Perché VM e non LXC?

Prima di procedere, analizziamo i motivi tecnici della scelta:

Isolamento: Ogni VM ha il proprio kernel; un crash di HA non impatta l’host Proxmox.
Supervisor: Indispensabile per installare Add-ons (es. Zigbee2MQTT, MariaDB) con un solo click.
Hardware Passthrough: Gestione più robusta delle periferiche USB (Zigbee sticks, Bluetooth dongles) senza dover mappare i permessi a livello di file system dell’host.

2. Risorse Hardware Assegnate (Specifications)

Per un’istanza fluida che possa gestire decine di automazioni e database, ho configurato i seguenti parametri:

Parametro	Valore	Note
CPU Type	`host`	Permette a HA di vedere tutte le istruzioni della CPU (fondamentale per AI/Media).
Cores	`2`	Sufficienti per la maggior parte dei task domestici.
RAM	`4 GB`	Previene lo swapping durante gli update degli add-ons.
Disk	`32 GB+`	SSD/NVMe raccomandato per velocità di scrittura database.
BIOS	`OVMF (UEFI)`	Obbligatorio per Home Assistant OS.
Machine	`q35`	Standard moderno per schede PCI ed emulazione hardware.

3. Procedura di Provisioning

Esistono due metodi: manuale (importando il file .qcow2 ufficiale) o tramite script di automazione (scelta consigliata per efficienza).

Metodo Helper Script (Best Practice)

Utilizziamo gli script di Proxmox Helper Scripts per garantire una configurazione ottimizzata:

Aprire la Shell del nodo Proxmox.
Eseguire il comando:

bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/vm/haos-vm.sh)"

Seguire il wizard selezionando Advanced Settings per confermare le risorse (CPU/RAM) sopra citate.

4. Configurazione Post-Installazione

Una volta creata la VM, è necessario configurare l’interfaccia con Proxmox.

QEMU Guest Agent

Assicurarsi che l’opzione sia abilitata nelle impostazioni della VM in Proxmox (Options -> QEMU Guest Agent -> Enabled).

Perché: Permette a Proxmox di comunicare con la VM per inviare comandi di shutdown pulito e leggere l’IP assegnato.

USB Passthrough (Zigbee/Z-Wave)

Se utilizzi una chiavetta (es. Sonoff ZBDongle-P):

Vai in Hardware della VM.
Add -> USB Device.
Seleziona Use USB Vendor/Device ID e scegli la tua periferica.
Spunta USB3 (se supportato) per ridurre la latenza.

📉 Workflow di Boot (Mermaid)

graph TD
    A[Start Proxmox Node] --> B[UEFI Boot HAOS]
    B --> C[Kernel Initialization]
    C --> D[Home Assistant Supervisor Start]
    D --> E[Add-ons Boot]
    E --> F[Home Assistant Core Start]
    F --> G[Port 8123 Accessible]

💡 Note per l’Ingegnere (Critical Thinking)

Storage Optimization: In Proxmox, abilita l’opzione Discard sul disco della VM se lo storage è su SSD, per permettere al sistema di eseguire il TRIM e allungare la vita del drive.
Backup: Prima di ogni aggiornamento di Home Assistant, esegui uno Snapshot in Proxmox. È infinitamente più veloce di un restore da backup interno di HA in caso di “breaking changes”.

Ultimo aggiornamento: {{UPDATE_DATE}} | Tags: #HomeAssistant #Proxmox #Infrastructure #Virtualization