Come spostare il data disk di Home Assistant su SSD NVMe

Prerequisiti & Hardware Necessario

• Hardware: installazione Home Assistant OS funzionante su Raspberry Pi 5, un SSD NVMe già rilevato dal Raspberry Pi M.2 HAT+ e alimentazione USB-C PD da 27 W. Riferimento per la scheda: Raspberry Pi 5 4GB con alimentatore ufficiale.
• Storage: l’SSD NVMe destinato ai dati deve avere capacità maggiore di quella del disco di avvio attuale, perché Home Assistant OS lo prepara e sovrascrive integralmente.
• Software: Home Assistant OS aggiornato, Home Assistant Supervisor e l’app Terminal & SSH oppure accesso alla console locale. Il data disk è una funzione di Home Assistant OS, non un normale montaggio Linux manuale.
• Backup: backup completo scaricato su un computer o su una destinazione esterna. Il trasferimento cancella il contenuto del disco NVMe selezionato.

Procedura passo-passo

1. Verifica che l’SSD NVMe sia collegato. Il disco deve essere già installato e rilevato come nell’articolo sul Raspberry Pi M.2 HAT+. Non inizializzarlo manualmente con fdisk, mkfs o strumenti simili: Home Assistant OS gestisce partizioni ed etichette del data disk.
2. Crea un backup completo. In Home Assistant apri Impostazioni → Sistema → Backup, crea un backup completo e scaricalo fuori dal Raspberry Pi. Verifica che il file sia leggibile prima di procedere.
3. Controlla il data disk attuale. Apri l’app Terminal & SSH oppure la console locale e usa:

   ha os info

   Annota il valore data_disk. Serve per distinguere il disco attuale dal nuovo NVMe e impedire una selezione errata.

4. Identifica il nuovo SSD dalla CLI, senza dedurre il nome.

   ha os datadisk list

   Se usi una console Linux separata per controllare l’hardware puoi anche eseguire lsblk, ma nel comando di migrazione usa esattamente il device elencato da ha os datadisk list, ad esempio /dev/nvme0n1.

5. Avvia lo spostamento dall’interfaccia grafica (metodo consigliato). Vai in Impostazioni → Sistema → Archiviazione, seleziona Sposta data disk, scegli l’SSD NVMe non ancora usato e conferma con Sposta. Controlla con attenzione modello e capacità del disco prima della conferma.
6. Oppure usa la CLI. Se l’interfaccia non mostra il disco, esegui il comando sostituendo il device con quello restituito dal passaggio precedente:

   ha os datadisk move /dev/nvme0n1

   Il sistema prepara il disco e riavvia immediatamente. Il riavvio può richiedere dieci minuti o più in base alla quantità di dati e alla velocità dell’SSD: non togliere alimentazione durante l’operazione.

7. Attendi la migrazione e accedi di nuovo. Dopo il riavvio attendi che Home Assistant torni disponibile, quindi apri Impostazioni → Sistema → Archiviazione e verifica il nuovo percorso del data disk. Le integrazioni, le app e la configurazione devono essere ancora presenti.
8. Controlla lo stato da CLI.

   ha os info
   ha core info
   ha supervisor info

   Il campo data_disk deve riferirsi alla nuova unità. Non confondere il percorso della partizione di avvio con quello del data disk.

9. Prova un riavvio controllato e aggiorna il backup. Riavvia da Impostazioni → Sistema → Riavvio, verifica che Home Assistant torni online e crea un nuovo backup dopo la migrazione. Conserva anche il backup precedente fino al completamento dei test.

Verifica del funzionamento

La migrazione è riuscita quando Home Assistant si riavvia senza errori, il data disk indicato da ha os info è l’SSD NVMe, app e integrazioni risultano disponibili e i nuovi log/backup vengono scritti sul disco esterno. Esegui un secondo riavvio e controlla che il percorso resti invariato. Se il vecchio disco era la microSD, questa deve rimanere disponibile per il boot solo se il tuo schema di avvio la utilizza.

Problemi comuni

Problema	Causa	Soluzione
L’SSD non compare in “Sposta data disk”	HAT, cavo FPC, formato SSD o firmware non compatibile	Verifica il rilevamento NVMe, aggiorna il firmware e controlla che il disco sia un NVMe M key compatibile.
Il comando rifiuta il disco	Device già usato, capacità insufficiente o partizioni residue	Controlla ha os datadisk list; il disco target deve essere più capiente del disco di boot e il suo contenuto verrà sovrascritto.
Home Assistant non risponde dopo la migrazione	Trasferimento ancora in corso o alimentazione interrotta	Attendi almeno dieci minuti, controlla i LED e non interrompere l’alimentazione; se il problema persiste, ripristina il backup da un supporto esterno.
Le app risultano mancanti	Il data disk non è stato montato oppure è stato selezionato il disco errato	Controlla ha os info, evita di ripetere la migrazione alla cieca e prepara il ripristino dal backup.
Il nuovo disco viene cancellato	La procedura di data disk prepara e sovrascrive il dispositivo	Non usare un SSD con dati da conservare; esegui sempre un backup prima della conferma.

FAQ essenziali

Il data disk sposta anche il sistema operativo?

No. Home Assistant OS mantiene il meccanismo di avvio e sposta sul disco esterno i dati, Home Assistant Core, Supervisor e le app supportate dalla funzione. È diverso dal clonare l’intero disco di boot.

Posso usare un SSD NVMe più piccolo ma con più spazio libero?

No. La documentazione di Home Assistant OS richiede che la capacità del disco esterno sia maggiore di quella del disco di avvio esistente, indipendentemente dallo spazio libero attualmente utilizzato.