Ultimo aggiornamento: 7 novembre 2026. Versioni testate: Home Assistant Core 2026.11.0, Supervisor 2026.10.5, Operating System 18.4, Frontend 20261028.4 (su Raspberry Pi 5), ESPHome Device Builder 2026.10.2.
Ogni dispositivo collegato al Wi-Fi ha un indirizzo, chiamato indirizzo IP, simile a 192.168.1.50. Di solito è il router a sceglierlo e può cambiarlo nel tempo. Per un dispositivo ESPHome un indirizzo che cambia non è quasi mai un problema, ma ci sono casi in cui avere un indirizzo stabile fa comodo. In questa guida ti spiego i due modi per ottenerlo, quando conviene l’uno o l’altro e gli errori che possono lasciarti con un dispositivo irraggiungibile.
Cosa otterrai
- La differenza chiara tra IP fisso su ESPHome e prenotazione sul router.
- Un esempio di configurazione corretto e il modo di ricavare i valori giusti per la tua rete.
- Una procedura sicura per cambiare indirizzo senza perdere il dispositivo.
Serve davvero un IP fisso?
Dipende. Home Assistant ritrova i dispositivi ESPHome in genere per nome (per esempio luce-soggiorno.local), quindi se tutto funziona puoi non fare nulla. L’IP stabile è utile quando:
- il tuo router o la tua rete non risolvono bene i nomi
.local; - vuoi collegarti al dispositivo con un indirizzo che conosci;
- vuoi ridurre il tempo che il dispositivo impiega a collegarsi al Wi-Fi. La documentazione ESPHome indica che l’IP fisso può accorciare in modo sensibile i tempi di connessione.
I due metodi a confronto
| Metodo | Dove si imposta | Vantaggi | Svantaggi |
|---|---|---|---|
IP fisso in ESPHome (manual_ip) | Nel file di configurazione del dispositivo | Collegamento più rapido, funziona anche se il router è poco affidabile | Devi conoscere gateway e subnet; se sbagli un valore il dispositivo sparisce dalla rete; il router non sa che l’indirizzo è occupato |
| Prenotazione DHCP sul router | Nel pannello del router | Gestione centralizzata, nessun rischio di valori sbagliati nel dispositivo, il router sa che l’indirizzo è riservato | Dipende dal router; se lo sostituisci va rifatta; il nome del menu cambia da marca a marca |
Il mio consiglio per chi inizia: usa la prenotazione sul router, perché è più difficile combinare guai. Usa manual_ip quando il router non offre la prenotazione o quando i nomi .local non funzionano. Puoi anche usare entrambi, purché l’indirizzo sia lo stesso. Io uso manual_ip su tutti i miei dispositivi: così restano raggiungibili e autonomi anche se un giorno cambio modem o router e il DHCP (il servizio che assegna gli indirizzi) non è più lo stesso. Il prezzo da pagare è annotare con cura gli indirizzi già usati, per non assegnarne due uguali.
Cosa serve
Alcuni link in questa pagina sono link di affiliazione: se acquisti da lì io ricevo una piccola commissione, senza alcun costo per te. Trovi i dettagli nella pagina Trasparenza e affiliazioni.
- Un dispositivo ESPHome già funzionante, collegato a Home Assistant.
- L’accesso alla pagina di amministrazione del router (di solito l’indirizzo è scritto sull’etichetta del router).
- Un foglio per annotare indirizzo, gateway e subnet.
Passo 1: ricavare i valori della tua rete
Per l’IP fisso servono tre valori. Se ne sbagli uno, il dispositivo non si collega più.
- Gateway: l’indirizzo del router. In molte reti domestiche è
192.168.1.1o192.168.0.1, ma non darlo per scontato: controllalo. - Subnet (maschera di rete): per le reti domestiche è spesso
255.255.255.0. - Indirizzo libero: un indirizzo della stessa rete, quindi con le prime tre cifre uguali al gateway, che nessun altro usi. Controlla l’elenco dei dispositivi del router e scegli un numero fuori dall’intervallo che il router assegna da solo (di solito lo trovi nelle impostazioni DHCP).
Dove trovarli: nel pannello del router, oppure in Home Assistant su Impostazioni → Sistema → Rete, dove vedi la configurazione del Raspberry, che è nella stessa rete.
Metodo A: IP fisso in ESPHome
Apri il dispositivo nel Device Builder e modifica il blocco wifi:
wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password
manual_ip:
static_ip: 192.168.1.50
gateway: 192.168.1.1
subnet: 255.255.255.0
dns1: 192.168.1.1
Le opzioni static_ip, gateway e subnet sono obbligatorie; dns1 è facoltativo. Gli indirizzi qui sopra sono esempi: sostituiscili con i tuoi. Dopo il salvataggio, premi Install per inviare la modifica.
Due precauzioni:
- Fai un dispositivo per volta, partendo da uno non importante.
- Scegli indirizzi diversi per ogni dispositivo. Due dispositivi con lo stesso IP si disturbano a vicenda.
Se il dispositivo ha un indirizzo e poi lo cambi, ESPHome potrebbe voler caricare l’aggiornamento sul vecchio indirizzo. In quel caso la documentazione indica l’opzione use_address sotto wifi, che dice a ESPHome quale indirizzo usare per raggiungere il dispositivo.
wifi:
# ... altre impostazioni ...
use_address: 192.168.1.40 # il vecchio indirizzo, solo per il prossimo aggiornamento
Dopo il cambio, togli di nuovo use_address o impostalo sul nuovo indirizzo.
Metodo B: prenotazione sul router
- Nel pannello del router cerca una voce simile a “DHCP statico”, “Prenotazione indirizzi” o “Address reservation”. Il nome cambia in base alla marca.
- Scegli il dispositivo dall’elenco, riconoscendolo dal nome o dall’indirizzo MAC.
- Indica l’indirizzo da riservare e salva.
- Riavvia il dispositivo ESPHome (puoi togliere e ridare corrente) in modo che riceva il nuovo indirizzo.
In questo caso non cambi nulla nel file ESPHome. I nomi dei menu cambiano da router a router: se non trovi la voce, cerca nel manuale del tuo modello. Io non uso questo metodo, quindi qui trovi la procedura generale.
Passo finale: dire a Home Assistant il nuovo indirizzo
Se il dispositivo è stato aggiunto tramite nome .local non devi fare nulla. Se l’avevi aggiunto con l’indirizzo IP, apri Impostazioni → Dispositivi e servizi → ESPHome e usa la riconfigurazione per aggiornare l’indirizzo. La documentazione di Home Assistant dice che l’integrazione supporta la riconfigurazione dell’indirizzo dopo l’installazione.
Problemi comuni
- Il dispositivo non risponde dopo la modifica. Quasi sempre gateway o subnet sono sbagliati, oppure l’indirizzo è fuori dalla tua rete. Se non riesce a collegarsi al Wi-Fi, dopo circa 90 secondi (tempo predefinito) parte l’hotspot di emergenza, se l’hai configurato: collegati e carica la configurazione corretta. Altrimenti serve il caricamento via cavo.
- Due dispositivi con lo stesso indirizzo. Succede se l’indirizzo scelto era già assegnato dal router. Riserva un intervallo fuori dalla zona DHCP.
- Cambio router o provider. Se il nuovo router usa una rete diversa (per esempio
192.168.178.x), tutti gli indirizzi fissi nei file vanno aggiornati. Con la prenotazione sul router basta rifarla. - Home Assistant segnala “non disponibile”. Controlla i log del dispositivo (vedi la guida dedicata) e verifica che l’indirizzo in Home Assistant sia ancora corretto.
Riepilogo
Per la maggior parte dei casi basta la prenotazione sul router. L’IP fisso in ESPHome con manual_ip è utile quando vuoi collegamenti più rapidi o il router non aiuta, ma richiede gateway, subnet e indirizzo corretti. Cambia un dispositivo per volta e tieni a portata di mano un modo per recuperarlo.
Articoli correlati
- Come installare ESPHome in Home Assistant e creare il primo dispositivo
- Come leggere i log e risolvere i problemi più comuni di ESPHome
- Come collegare un Sonoff Mini a Home Assistant con ESPHome