Partiendo de que se ha instalado el sistema operativo directamente sobre el hardware.
Si no has instalado Home Assistant y quieres hacerlo en Proxmox, consulta la guía de VMs y Contenedores para crear una VM de HAOS.
HACS (Home Assistant Community Store) es la tienda de la comunidad y es necesaria tanto para instalar Matterbridge como para los dispositivos Zigbee. Antes de instalarlo hay que activar el modo avanzado en el panel de perfil poniendo el interruptor en ON, ya que se necesita acceso a una terminal SSH. Se puede seguir este vídeo de referencia: Instalación del repositorio de la comunidad.
wget -O - https://get.hacs.xyz | bash -
Tras ejecutar el comando hay que reiniciar el dispositivo e ir a Ajustes → Integraciones para completar la instalación de HACS y seleccionar todas las opciones.
El vídeo de referencia puede mostrar una interfaz de HACS diferente a la actual. En versiones antiguas había que pulsar el botón "Explore & Download Repositories" dentro de la sección de integraciones de HACS. En HACS 2.x ese botón ya no existe: la interfaz está en hacs/dashboard y basta con buscar la integración directamente por nombre, hacer clic en el resultado y pulsar Download. Tras la descarga hay que reiniciar Home Assistant.
Es posible que tengas que reiniciar el dispositivo.
Para completar la instalación de HACS es necesario tener una cuenta de GitHub.
Para controlar los dispositivos de Home Assistant por voz desde Alexa o Google Home hay dos opciones locales (sin Nabu Casa):
Si estás instalando Home Assistant en Proxmox (como VM de HAOS), el add-on se instala igual que en hardware. Si usas Home Assistant Container (Docker) en Proxmox, consulta la guía de VMs y Contenedores para crear un contenedor con Docker y seguir los pasos de instalación del add-on.
| Opción | Descripción | Video |
|---|---|---|
| Matterbridge | Plugin más conocido y establecido. Requiere configurar un plugin adicional (matterbridge-hass). | HectorziN |
| Matter Hub | Fork activo (RiDDiX) con interfaz más moderna. No requiere plugin extra. | YouTube |
Ambas soluciones funcionan 100% en local, sin pasar por la nube y sin abrir puertos. Elige la que prefieras.
Para la instalación de las aplicaciones necesarias se puede seguir el siguiente vídeo de referencia: Instalación de aplicaciones necesarias.
El coordinador es el dispositivo que conecta la red Zigbee con Home Assistant. Actualmente hay dos coordinadores documentados:
Esta guía está elaborada usando un bridge Sonoff Zigbee y dispositivos de la misma marca. Si se utiliza un bridge de otra marca (IKEA, ConBee, Sonoff Zigbee 3.0 USB Dongle, etc.) el proceso general es el mismo, pero algunos pasos concretos como el emparejamiento del bridge o los ajustes del coordinador pueden variar ligeramente.
Consulta la guía de configuración de tu coordinador:
No todos los tipos de dispositivo son compatibles con Matter y Alexa. Los pulsadores (entidades de tipo button o event) no están soportados porque Matter solo reconoce dispositivos con un estado (encendido/apagado, porcentaje, etc.), y un pulsador únicamente dispara acciones sin tener estado propio. Los tipos compatibles son: light, switch, cover, climate, fan y algunos sensor.