DomotiCasa

La tua guida alla casa intelligente

installare server matter su home assistant

Come Installare il Server Matter su Home Assistant

Giovanni Provenzano015 mins

Matter è lo standard aperto più recente per la domotica intelligente, consentendo il controllo completo dei dispositivi smart home localmente senza dipendere dal cloud. Home Assistant ha ricevuto la certificazione ufficiale della Connectivity Standards Alliance (CSA) per la sua implementazione di Matter, garantendo piena compatibilità e affidabilità. Questa guida ti insegnerà come installare e configurare il server Matter su Home Assistant, indipendentemente dal tipo di installazione che utilizzi.

Cos’è il Server Matter e Perché è Importante

Il server Matter è un componente separato che gestisce la comunicazione tra Home Assistant e i tuoi dispositivi Matter. Funziona come “Matter controller” e crea una rete Matter locale (chiamata Fabric) sul tuo Wi-Fi o sulla rete Thread. Il server comunica con Home Assistant tramite una connessione WebSocket sulla porta 5580, mantenendo tutto il controllo locale e privato.

Vantaggi dell’utilizzo di Matter:

  • Comunicazione completamente locale (nessun cloud esterno)​

  • Controllo rapido e reattivo dei dispositivi

  • Compatibilità con innumerevoli marchi e dispositivi certificati Matter

  • Privacy garantita: i tuoi dati rimangono sempre locali

  • Supporto per dispositivi sia Wi-Fi che Thread

Requisiti Preliminari

Prima di iniziare l’installazione del server Matter, assicurati di avere quanto segue:

  • Home Assistant versione aggiornata (consigliato: versione 2025.x o successiva)

  • Connessione stabile Wi-Fi (2.4 GHz o 5 GHz, a seconda dei dispositivi)

  • Dispositivi Matter da aggiungere (controllori intelligenti, sensori, luci, prese, termostati, ecc.)

  • Accesso amministratore alle impostazioni di Home Assistant

  • IPv4 e IPv6 abilitati sulla rete (non è necessario usarli attivamente, ma devono essere disponibili)

  • Memoria RAM sufficiente: almeno 1-2 GB liberi su Home Assistant

Metodo 1: Installazione su Home Assistant OS (Consigliato)

Questo è il metodo più semplice e consigliato per chi utilizza Home Assistant OS su Raspberry Pi, NUC o altre piattaforme supportate.

Passo 1: Accedi a Home Assistant

Apri l’interfaccia web di Home Assistant sul browser digitando l’indirizzo IP del tuo server (es. http://192.168.1.100:8123) e accedi con le tue credenziali.

Passo 2: Naviga alle Impostazioni

Vai a Impostazioni (Settings) nel menu laterale sinistro, poi seleziona Dispositivi e servizi (Devices & Services).

Passo 3: Aggiungi l’Integrazione Matter

  1. Fai clic sul pulsante blu Crea automazione (Create Automation) o cerca il pulsante Aggiungi integrazione (Add Integration)

  2. Cerca “Matter” nella barra di ricerca

  3. Seleziona “Matter” dai risultati

Passo 4: Installa il Server Add-on

  1. Nella finestra di dialogo “Seleziona metodo di connessione”, se utilizzi Home Assistant OS in una configurazione standard, seleziona Invia (Submit)

  1. Home Assistant installerà automaticamente l’add-on ufficiale Matter Server nel sistema

  2. Il processo di installazione potrebbe richiedere alcuni minuti

  3. Una volta completato, riceverai una notifica di conferma

Nota importante: L’add-on ufficiale Matter Server non è supportato su piattaforme a 32-bit. Se possiedi una versione a 32-bit, dovrai utilizzare uno dei metodi alternativi descritti più avanti.

Passo 5: Verifica l’Installazione

  1. Torna a Impostazioni > Dispositivi e servizi

  2. Dovresti vedere “Matter” nella lista delle integrazioni installate

  3. Fai clic su “Matter” per visualizzare lo stato e i dettagli della connessione

Metodo 2: Installazione su Home Assistant Container (Docker)

Se utilizzi Home Assistant tramite Docker, il processo è leggermente diverso.

Passo 1: Installa il Matter Server Container

Puoi installarla come container Docker separato. Usa questo comando:

docker run -d \
  --name matter-server \
  --network host \
  -e PYTHONUNBUFFERED=1 \
  ghcr.io/open-home-foundation/python-matter-server:latest

Questo comando crea un container Docker che esegue il server Matter sulla stessa rete di Home Assistant.

Passo 2: Configura la Connessione WebSocket

  1. Accedi a Home Assistant e vai a Impostazioni > Dispositivi e servizi

  2. Aggiungi l’integrazione Matter

  3. Quando ti viene chiesto il metodo di connessione, deseleziona la checkbox “Installa il server add-on”

  4. Nel campo URL, inserisci: ws://localhost:5580/ws (se il container Matter è sulla stessa macchina)

  5. Se il container Matter è su un’altra macchina, sostituisci “localhost” con l’IP del server Matter

Passo 3: Verifica la Connessione

Home Assistant dovrebbe connettersi automaticamente al server Matter. Se la connessione riesce, riceverai una conferma e potrai procedere ad aggiungere i dispositivi.

Metodo 3: Installazione su Home Assistant Core (Manuale)

Per chi utilizza Home Assistant Core su un’installazione Python diretta:

Passo 1: Installa il Server Matter via pip

Esegui questo comando nel terminale del sistema che ospita Home Assistant:

pip install python-matter-server

Passo 2: Avvia il Server Matter

Lancia il server con il comando:

matter-server

Il server ascolterà sulla porta 5580.

Passo 3: Configura Home Assistant

  1. In Home Assistant, vai a Impostazioni > Dispositivi e servizi

  2. Aggiungi l’integrazione Matter

  3. Deseleziona la checkbox di installazione dell’add-on

  4. Inserisci l’URL: ws://localhost:5580/ws (o l’IP del server se su una macchina diversa)

Configurazione Avanzata: Thread Border Router (OTBR)

Se desideri utilizzare il protocollo Thread (a bassa potenza e maglia) per estendere la portata dei tuoi dispositivi, avrai bisogno di un Thread Border Router:

Passo 1: Prepara l’Hardware Thread

Avrai bisogno di un dispositivo Thread Border Router, come:

  • Una chiave USB Thread-compatible (es. dongle RCP – Radio Co-Processor)

  • Un hub intelligente compatibile (es. Nanoleaf Essentials, Sonos Arc, Apple HomePod mini)

Passo 2: Installa l’Integrazione OTBR (OpenThread Border Router)

  1. In Home Assistant, vai a Impostazioni > Dispositivi e servizi

  2. Aggiungi l’integrazione OTBR (OpenThread Border Router)

  3. Seleziona il tuo dispositivo Thread Border Router

Passo 3: Configura la Rete Thread

  1. Accedi all’interfaccia web di OTBR (generalmente su http://localhost:8081)

  2. Verifica che il dongle Thread sia riconosciuto correttamente

  3. Crea una nuova rete Thread o unisciti a una esistente

  4. Abilita le credenziali “Utilizzate per Android + iOS” per garantire la compatibilità

Passo 4: Connetti al Server Matter

Il server Matter di Home Assistant riconoscerà automaticamente la rete Thread disponibile e inizierà a scoprire i dispositivi Thread nella rete.

Aggiunta di Dispositivi Matter

Una volta che il server Matter è installato e funzionante, puoi iniziare ad aggiungere i tuoi dispositivi:

Passo 1: Prepara il Dispositivo Matter

Metti il dispositivo in modalità di associazione (di solito tenendo premuto un pulsante per 3-5 secondi fino a quando la luce non lampeggia).

Passo 2: Aggiungi il Dispositivo a Home Assistant

  1. Vai a Impostazioni > Dispositivi e servizi > Matter

  2. Fai clic su Aggiungi dispositivo (Add Device)

  3. Seleziona Aggiungi un nuovo dispositivo Matter

  4. Scansiona il codice QR del dispositivo (presente sull’etichetta) o inserisci il codice di setup manualmente

Passo 3: Conferma l’Aggiunta

Home Assistant scoprirà il dispositivo automaticamente. Una volta completato il processo, il dispositivo sarà disponibile nel dashboard di Home Assistant e potrai controllarlo immediatamente.

Condivisione di Dispositivi Matter da altre Piattaforme

Se possiedi un dispositivo Matter già accoppiato con Apple Home o Google Home, puoi condividerlo con Home Assistant senza riconfigurarlo:

Da Apple HomeKit:

  1. Apri l’app Apple Home

  2. Seleziona il dispositivo da condividere

  3. Accedi alle impostazioni del dispositivo e seleziona “Aggiungi a un’altra Piattaforma Home”

  4. Scansiona il codice QR con il dispositivo Home Assistant Companion

  5. In Home Assistant, vai a Impostazioni > Dispositivi e servizi > Matter

  6. Seleziona “Aggiungi un dispositivo già in uso”

Da Google Home:
Segui lo stesso processo, ma utilizza l’app Google Home per generare il codice QR di condivisione.

Troubleshooting: Problemi Comuni e Soluzioni

Problema: il Server Matter Non Si Avvia

Cause possibili:

  • Memoria RAM insufficiente

  • Porta 5580 già in uso

  • Versione di Home Assistant obsoleta

Soluzioni:

  1. Assicurati di avere almeno 1-2 GB di RAM libera su Home Assistant

  2. Verifica che nessun’altra applicazione stia usando la porta 5580 (su Linux: sudo lsof -i :5580)

  3. Aggiorna Home Assistant all’ultima versione

  4. Riavvia il container/add-on Matter Server

Problema: Errore “Could Not Resolve Host Supervisor”

Questo errore appare solitamente nelle installazioni su container Docker.

Soluzioni:

  1. Assicurati che il container Matter e Home Assistant siano sulla stessa rete Docker

  2. Usa --network host per il container Matter

  3. Se sono su Docker separati, usa l’IP del server Matter invece di localhost

  4. Verifica che il firewall della macchina non blocchi la porta 5580

Problema: i Dispositivi Non Vengono Rilevati

Cause possibili:

  • Il dispositivo non è in modalità di associazione

  • La distanza dal router Wi-Fi è eccessiva

  • Il dispositivo non supporta Matter

Soluzioni:

  1. Riporta il dispositivo in modalità di associazione

  2. Avvicina il dispositivo al router Wi-Fi durante l’associazione

  3. Verifica che il dispositivo sia certificato Matter sul sito della CSA

  4. Verifica i log di Home Assistant per errori specifici

Problema: Latenza Elevata o Dispositivi Lenti a Rispondere

Soluzioni:

  1. Migliora il segnale Wi-Fi con un router di qualità

  2. Se utilizzi Thread, assicurati di avere un Thread Border Router stabile

  3. Riduci il numero di dispositivi per evitare sovraccarico del server

  4. Verifica che non ci siano interferenze da altri dispositivi sulla banda 2.4 GHz

Best Practices per un Setup Matter Stabile

Configurazione iniziale:

  • Inizia con pochi dispositivi (3-5) prima di aggiungerne molti

  • Testa la stabilità per almeno una settimana prima di aggiungere automazioni complesse

  • Mantieni il server Matter e Home Assistant sulla stessa rete locale

Manutenzione regolare:

  • Controlla gli aggiornamenti di Home Assistant e del server Matter mensilmente

  • Monitora l’utilizzo della memoria e della CPU

  • Riavvia il server Matter ogni mese per prevenire memory leak

  • Mantieni i dispositivi Matter aggiornati con gli ultimi firmware

Sicurezza:

  • Non esporre il server Matter su internet (mantienilo su LAN locale)

  • Usa credenziali forti per Home Assistant

  • Abilita l’autenticazione a due fattori su Home Assistant

L’installazione del server Matter su Home Assistant ti permette di costruire un ecosistema di smart home completamente locale, veloce e sicuro. Che tu stia utilizzando Home Assistant OS, Container o Core, i metodi descritti sopra ti guideranno attraverso il processo. Con la certificazione ufficiale di Home Assistant da parte della CSA, puoi avere piena fiducia nella compatibilità e nella qualità della tua installazione Matter. Segui i passaggi accuratamente, applica le soluzioni di troubleshooting se necessario, e avrai un sistema domotico moderno, affidabile e completamente sotto il tuo controllo.

Titoli Correlati