Obiettivo: Configurare un ambiente di sviluppo professionale sulla workstation locale per gestire la configurazione remota di Home Assistant.
::: info
Lavorare in remoto con VS Code permette di utilizzare funzionalità avanzate come il Linting (controllo errori in tempo reale), l'Autocomplete delle entità e la gestione dei file tramite Git, mantenendo la potenza di calcolo sulla macchina di sviluppo e i file sulla VM Proxmox.
:::
Per permettere a VS Code di connettersi, dobbiamo aprire un canale SSH sicuro.
- Installa l'Add-on Advanced SSH & Web Terminal (da HACS o dallo store ufficiale).
- Configura l'Add-on:
- Imposta una password robusta o (scelta consigliata) aggiungi la tua chiave SSH pubblica (ED25519).
- Assicurati che la porta
22 (o una porta custom come 2222) sia aperta e configurata.
- Disabilita
sftp se preferisci usare solo il protocollo SSH puro.
Sulla tua macchina di sviluppo (Windows/Linux/Mac), procedi come segue:
Installa le seguenti estensioni dal Marketplace di VS Code:
- Remote - SSH: Per connettersi al filesystem della VM.
- Home Assistant Config Help: Fornisce l'autocompletamento per le entità e la validazione dello schema YAML.
- Premi
F1 e digita Remote-SSH: Connect to Host....
- Configura il file di config SSH locale:
Host homeassistant-server
HostName 192.168.1.XXX # IP della VM HA
User root
Port 22
IdentityFile ~/.ssh/id_ed25519
- Connettiti e apri la cartella
/config.
Per fare in modo che VS Code riconosca le tue luci, sensori e script, dobbiamo collegare l'estensione alle API di Home Assistant.
- In Home Assistant: Vai sul tuo Profilo -> Long-Lived Access Tokens.
- Genera un nuovo token chiamato
VSCode-Remote.
- In VS Code: Vai nelle impostazioni dell'estensione "Home Assistant" e inserisci:
- Host URL:
http://192.168.1.XXX:8123
- Access Token: (Il token appena generato)
- Certificato: Disabilita la verifica SSL se usi un IP locale senza HTTPS valido internamente.
graph LR
subgraph Workstation_Locale
VSC[VS Code IDE]
EXT[HA Extension]
end
subgraph Proxmox_VM
HA[Home Assistant OS]
SSH[SSH Add-on]
CONF[/config/*.yaml]
end
VSC -- "Remote-SSH (Filesystem)" --> SSH
SSH <--> CONF
EXT -- "REST/WS API (Entities/Linting)" --> HA
- Validazione Sintattica: VS Code sottolineerà in rosso se dimentichi un'indentazione o se scrivi male un servizio, evitando di dover riavviare HA e scoprire l'errore dai log.
- Snippets: Possibilità di creare template personalizzati per automazioni ripetitive.
- Git Integration: Puoi inizializzare un repository Git nella cartella
/config e pushare le modifiche su un server privato (Gitea/GitHub), garantendo un versionamento reale di tutta la tua domotica.
Tags: #HomeAssistant #VSCode #RemoteDevelopment #YAML #Linting*