Come creare una macchina virtuale Home Assistant su Proxmox VE

Prerequisiti & Hardware Necessario

• Un host Proxmox VE funzionante su hardware x86-64 con virtualizzazione Intel VT-x/AMD-V attiva.
• Almeno 4 GB di RAM liberi per la VM e 2 vCPU dedicate. Per installazioni complesse assegna risorse aggiuntive senza esaurire la memoria dell’host.
• Storage Proxmox con spazio sufficiente per il disco virtuale di Home Assistant.
• Bridge di rete funzionante, normalmente vmbr0.
• Accesso amministrativo alla shell Proxmox o all’interfaccia web.

Proxmox VE è il software hypervisor. Home Assistant OS è il sistema operativo guest della VM. Non usare l’immagine generic-x86-64 per questa procedura: scarica l’immagine ufficiale KVM/Proxmox in formato QCOW2.

Per Home Assistant OS in una macchina virtuale, la documentazione ufficiale indica almeno 2 GB di RAM e 2 vCPU. In questa guida vengono assegnati 4 GB di RAM per lasciare margine a Supervisor e app.

Procedura passo-passo

1. Apri la pagina Home Assistant: Alternative installations e individua il collegamento KVM/Proxmox (.qcow2).
2. Copia l’URL della versione corrente dell’immagine OVA, che normalmente ha formato haos_ova-<versione>.qcow2.xz. Non fissare una versione obsoleta se è disponibile una release più recente.
3. Apri la shell del nodo Proxmox e imposta le variabili, sostituendo versione e storage con valori reali: VMID=100, STORAGE=local-lvm e VERSION=17.3.
4. Scarica e decomprimi l’immagine con wget -O /var/lib/vz/template/iso/haos_ova-$VERSION.qcow2.xz https://github.com/home-assistant/operating-system/releases/download/$VERSION/haos_ova-$VERSION.qcow2.xz e unxz /var/lib/vz/template/iso/haos_ova-$VERSION.qcow2.xz.
5. Crea la VM senza disco con qm create $VMID --name homeassistant --memory 4096 --cores 2 --machine q35 --bios ovmf --ostype l26 --net0 virtio,bridge=vmbr0.
6. Importa il disco QCOW2 nello storage Proxmox con qm importdisk $VMID /var/lib/vz/template/iso/haos_ova-$VERSION.qcow2 $STORAGE.
7. Collega il disco importato come SCSI usando qm set $VMID --scsihw virtio-scsi-single --scsi0 $STORAGE:vm-$VMID-disk-0,discard=on,iothread=1.
8. Aggiungi il disco EFI con qm set $VMID --efidisk0 $STORAGE:0,efitype=4m,pre-enrolled-keys=1 e imposta il boot sul disco SCSI con qm set $VMID --boot order=scsi0.
9. Controlla dalla scheda Hardware della VM che rete, disco SCSI, firmware OVMF e disco EFI siano presenti.
10. Avvia la VM con qm start $VMID, attendi il primo avvio e apri http://homeassistant.local:8123 oppure l’IP assegnato dal DHCP.

Nota sui nomi dello storage

local-lvm è solo un esempio. Se il nodo usa local-zfs, NFS o un altro storage, sostituisci il valore in tutti i comandi. Verifica gli storage disponibili con pvesm status.

Configurazione dell’onboarding

Crea l’account amministratore, imposta posizione e fuso orario, poi riserva l’indirizzo IP della VM nel router. Crea il primo backup da Impostazioni → Sistema → Backup.

Verifica del funzionamento

La VM è configurata correttamente quando lo stato è running, il disco SCSI è collegato, Home Assistant risponde sulla porta 8123 e il riavvio della VM non modifica i dati.

qm status $VMID
pvesh get /nodes/$(hostname)/qemu/$VMID/status/current
pvesm status

Dall’interfaccia Proxmox controlla CPU, memoria, storage e traffico della scheda di rete. In Home Assistant controlla Impostazioni → Sistema → Riparazioni e crea un backup completo.

Riavvia la VM da Proxmox e verifica che torni disponibile senza ricreare il disco o modificare il boot order.

Problemi comuni

FAQ essenziali

Posso usare una VM Linux e installare Home Assistant Container?

Sì, ma è un’architettura diversa. Questa guida usa Home Assistant OS in VM, che include Supervisor e app. Non mescolare le due procedure nella stessa macchina virtuale.

Servono 4 GB di RAM?

Home Assistant OS può avviarsi con 2 GB e 2 vCPU, ma 4 GB offrono più margine per app e integrazioni. La RAM assegnata alla VM deve restare disponibile anche per l’host Proxmox.