Homebridge para principiantes: guía completa para usarlo con HomeKit

iPhone World » General » Homebridge para principiantes: guía completa para usarlo con HomeKit

Si te gusta la domótica en casa y eres usuario de Apple, tarde o temprano te topas con un problema: hay montones de bombillas, enchufes, cámaras o robots aspiradores que funcionan con Alexa o Google Assistant, pero que pasan olímpicamente de HomeKit. Y claro, si ya tienes un iPhone, un iPad o un Apple TV, lo lógico es querer controlarlo todo desde la app Casa y con Siri.

Ahí es donde entra Homebridge, un proyecto de software gratuito que actúa como puente entre el mundo de HomeKit y esos dispositivos que, en teoría, no son compatibles. Gracias a una comunidad enorme y a miles de plugins, permite que tu iPhone vea como “nativos” aparatos que originalmente solo hablaban con otras plataformas.

Qué es Homebridge y por qué es tan útil para HomeKit

Homebridge es, en esencia, un servidor ligero programado en Node.js que se ejecuta dentro de tu red local. Su trabajo es “emular” la API de HomeKit, de forma que tus dispositivos Apple piensan que están hablando con accesorios oficiales, cuando en realidad Homebridge hace de traductor entre HomeKit y las APIs de terceros (Nest, Ring, TP-Link, etc.).

La gracia está en su sistema de plugins desarrollados por la comunidad. Cada plugin sabe hablar con una marca o servicio concreto (por ejemplo, cámaras Nest o aspiradores Roomba) y los expone a HomeKit como si fueran accesorios nativos. Así, tu app Casa y Siri pueden manejarlos sin notar diferencia frente a un enchufe certificado por Apple.

El objetivo del proyecto es muy claro: llevar HomeKit a dispositivos que no lo soportan de fábrica. En la práctica, esto te permite aprovechar ofertas, marcas baratas o equipos antiguos que solo integran Alexa o Google Assistant, pero que a ti te interesa controlar desde el ecosistema de Apple sin tener que duplicar aplicaciones.

Lo mejor de todo es que, una vez configurado, el uso diario es totalmente transparente. Controlarás tus accesorios “no compatibles” igual que los oficiales, ya sea pidiéndole algo a Siri (“oye Siri, apaga las luces del salón”) o entrando en la app Casa. Si además tienes un Apple TV, un HomePod o un iPad como central de accesorios, podrás manejarlos también desde fuera de casa.

Plataformas de domótica y el papel de Homebridge

Hoy en día conviven tres grandes ecosistemas de hogar inteligente basados en asistentes de voz: Alexa con los dispositivos Echo de Amazon, Google Assistant con los Google Home / Nest, y Siri a través de HomeKit en el entorno Apple. Cada uno tiene su catálogo de accesorios, su app y su forma de entender la domótica.

Los que ya viven metidos de lleno en el ecosistema de la manzana suelen preferir usar HomeKit y Siri como centro de control, porque todo está integrado en iOS, iPadOS, macOS y tvOS, y porque permite automatizaciones muy potentes con un nivel alto de privacidad. Puedes invocar a Siri desde el iPhone, el Apple Watch, el Mac, el HomePod o el Apple TV para manejar la casa.

El problema llega cuando miras el mercado y ves que, aunque hay muchos accesorios compatibles con HomeKit (enchufes, sensores de fuga, termostatos, tiras LED, cámaras, routers, etc.), la lista es bastante más corta que la de Alexa o Google Assistant. Y para rematar, a menudo los modelos con soporte oficial para HomeKit son más caros que sus equivalentes solo Alexa/Google.

Muchos usuarios acaban comprando productos pensados principalmente para Alexa porque tienen mejor precio, más variedad o simplemente porque el fabricante ha pasado de certificar su producto para HomeKit. Y es justo ese hueco el que viene a cubrir Homebridge, haciendo que estos aparatos “se camuflen” como si hablaran el idioma de Apple.

Cómo funciona Homebridge en tu red doméstica

A nivel práctico, Homebridge es un programa que instalas en un ordenador o dispositivo que actúa como servidor dentro de tu red doméstica. Puede ser un Mac, un PC con Windows, una Raspberry Pi, un NAS o una máquina Linux. Lo importante es que esté siempre encendido y con conexión estable a Internet para que los accesorios estén accesibles en todo momento.

Cuando arrancas Homebridge, este se anuncia en la red como si fuera un puente HomeKit oficial. Desde la app Casa, lo añades escaneando un código (como haces con cualquier accesorio compatible) y, a partir de ahí, todos los accesorios que aporten sus plugins se irán mostrando dentro de HomeKit.

La configuración y el día a día se gestionan mediante una interfaz web muy cómoda que se sirve, por defecto, en el puerto 8581 de la máquina donde se ha instalado. En un navegador, accedes normalmente con una URL del tipo http://localhost:8581 o http://IP-DE-TU-SERVIDOR:8581 y allí podrás instalar plugins, revisarlos, borrarlos, actualizar Homebridge y editar el archivo de configuración.

Algunos usuarios prefieren conectar este servidor por cable Ethernet al router en lugar de usar Wi‑Fi, sobre todo cuando la casa tiene muchos accesorios. Esto reduce los cortes de conexión y hace que las órdenes de HomeKit se procesen con más rapidez y fiabilidad.

Requisitos mínimos y hardware recomendado para Homebridge

Homebridge está diseñado pensando en el ecosistema Apple y HomeKit, por lo que, además del servidor, necesitarás varios elementos mínimos para sacarle partido: dispositivos iOS para gestionarlo y, si quieres control remoto fuera de casa, una central de accesorios de Apple.

Como base, vas a necesitar un iPhone, iPad o iPod touch con iOS 12 o superior (o versiones modernas de iPadOS) para configurar la app Casa. Desde ella añadirás Homebridge como si fuera un puente y también gestionarás cuartos, escenas y automatizaciones.

Si te interesa encender luces, subir persianas o mirar cámaras estando lejos de casa, te hará falta un Home Hub: un Apple TV HD/4K, un HomePod (mini o grande) o un iPad que se quede siempre en casa y conectado. Este dispositivo actuará como “centralita” para que los accesorios de HomeKit (incluidos los que pasan por Homebridge) sean accesibles desde Internet.

En cuanto al servidor, puedes utilizar un Mac, un PC con Windows o una Raspberry Pi. Lo importante es que se mantenga encendido y con conexión estable. Mucha gente opta por una Raspberry Pi porque consume poquísimo, es barata y se puede dedicar casi en exclusiva a Homebridge, aunque también puede hacer de servidor multimedia, bloqueador de anuncios, etc.

Otra opción que muchos aprovechan es un NAS con sistema operativo completo o soporte Docker. Si ya lo tienes funcionando como servidor de copias de seguridad, multimedia o torrents, puedes añadir Homebridge sin necesidad de montar un dispositivo más. Eso sí, comprar un NAS solo para esto puede ser caro si no le vas a dar otros usos.

Por último, es recomendable que tu router soporte doble banda Wi‑Fi (2,4 y 5 GHz) para gestionar mejor todos los cacharros conectados a la red, especialmente si combinas dispositivos HomeKit nativos con otros que dependen de Homebridge y de distintas marcas.

Instalar Homebridge en macOS, Windows y Linux

Aunque el hardware recomendado varía, la base técnica es común: Homebridge funciona sobre Node.js en los sistemas operativos más habituales. La comunidad mantiene guías detalladas para macOS, Windows 10 y distribuciones Linux como Debian, Ubuntu o Raspbian.

En un Mac, lo ideal es asegurarte de que usas una versión reciente de macOS y que te sientes cómodo abriendo la app Terminal. Desde ahí instalarás la versión LTS de Node.js (por ejemplo, 14.x en muchas guías oficiales) usando el instalador estándar de Node que se descarga desde la web oficial.

Una vez tengas Node.js en su sitio, puedes instalar Homebridge y su interfaz de usuario con un comando global. Normalmente se utiliza algo del estilo sudo npm install -g –unsafe-perm homebridge homebridge-config-ui-x, que deja ambos componentes instalados en el sistema listos para funcionar.

Para que Homebridge se inicie solo cada vez que enciendas el Mac, se suele usar hb-service, un comando que configura el servicio como demonio de sistema. Con sudo hb-service install se crea el servicio necesario y se vincula a tu usuario actual, de manera que no tengas que lanzar Homebridge a mano tras cada reinicio.

Después de esto, podrás entrar en la interfaz web en http://localhost:8581 con un usuario y contraseña por defecto (normalmente admin / admin, que deberías cambiar). Desde esa pantalla, verás el estado del servidor, podrás instalar plugins y revisar el archivo de configuración config.json, que suele guardarse en la ruta ~/.homebridge/config.json en macOS.

En un PC con Windows 10 el proceso es parecido, pero usando el símbolo del sistema de Node.js con privilegios de administrador. Primero instalas la versión LTS de Node.js mediante el instalador de 32 o 64 bits que corresponda a tu sistema, y luego, en la consola, ejecutas un comando similar para instalar Homebridge y la interfaz gráfica.

Una vez instalado, puedes usar también hb-service install en Windows para registrar Homebridge como servicio y que se inicie automáticamente. Es posible que Windows te saque algún aviso del cortafuegos; en ese caso, conviene permitir a Node.js el acceso a la red privada para que Homebridge pueda anunciarse correctamente en la red local.

Las rutas de configuración cambian en Windows, normalmente apuntando a %HOMEPATH%\.homebridge\config.json como archivo principal de configuración y al mismo directorio para el almacenamiento. Los comandos hb-service restart, stop, start o logs permiten reiniciar el servicio, detenerlo, iniciarlo y ver los registros desde consola.

En sistemas Linux como Debian, Ubuntu o Raspbian (muy habituales en Raspberry Pi), el flujo empieza por asegurarse de que el sistema está actualizado con apt-get update y apt-get upgrade. Después se instalan paquetes básicos como git, make y g++ para poder compilar módulos nativos que pueda necesitar algún plugin de Homebridge.

Acto seguido se instala Node.js desde un repositorio oficial o siguiendo las instrucciones de NodeSource, y después se añaden dependencias como libavahi-compat-libdnssd-dev, que se usan para el anuncio de servicios tipo Bonjour/ZeroConf, algo clave para que HomeKit encuentre a Homebridge en la red.

Con esto listo, se lanza de nuevo el comando sudo npm install -g –unsafe-perm homebridge homebridge-config-ui-x y, tras la instalación, se configura el arranque automático con hb-service, por ejemplo: sudo hb-service install –user homebridge. Eso creará un servicio systemd, un archivo de configuración de entorno y establecerá /var/lib/homebridge como ruta principal de datos.

En Linux, las referencias típicas son: /var/lib/homebridge/config.json como archivo de configuración, /var/lib/homebridge como almacenamiento, y /etc/systemd/system/homebridge.service para el servicio systemd que se encarga de iniciarlo en cada arranque. Para ver los registros del servicio se recurre a sudo hb-service logs o directamente al journal de systemd.

Instalar y configurar Homebridge en una Raspberry Pi

La Raspberry Pi se ha convertido casi en el dispositivo estrella para montar Homebridge por su bajo consumo, tamaño reducido y precio ajustado. Con una Raspberry Pi 3 o 4, una tarjeta microSD y una fuente de alimentación decente tienes más que de sobra para gestionar decenas de accesorios de domótica.

El primer paso al preparar una Pi con Raspberry Pi OS es actualizar el sistema con los clásicos comandos apt-get update y apt-get upgrade. Esto garantiza que dispones de los últimos paquetes, correcciones de seguridad y versiones compatibles de las herramientas necesarias.

Después se instalan utilidades como git y make mediante apt-get install git make, y si es necesario, el compilador g++ para poder compilar componentes nativos. Conviene comprobar que la versión de gcc/g++ es relativamente moderna (por encima de 4.9 suele ser suficiente para la mayoría de plugins).

Una vez al día, se instala Node.js desde el repositorio adecuado, ya sea utilizando un script de NodeSource (por ejemplo, apuntando a la rama 7.x en guías antiguas, o a una versión LTS más reciente en las actuales) y luego añadiéndolo con apt-get install -y nodejs.

También es importante instalar Avahi y las librerías de compatibilidad con libdnssd, algo que se resuelve con apt-get install libavahi-compat-libdnssd-dev. Esto permite que Homebridge sea visible para los dispositivos Apple usando el protocolo de descubrimiento Bonjour, imprescindible en el ecosistema de Apple.

Finalmente, se ejecuta el comando típico para instalar Homebridge de forma global: sudo npm install -g –unsafe-perm homebridge. Tras unos minutos de instalación, puedes lanzar homebridge por primera vez desde la terminal como usuario normal con el comando homebridge para comprobar que todo arranca sin errores.

En ese primer arranque, Homebridge genera un código de emparejamiento tipo HomeKit (por ejemplo, 031-45-154) que tendrás que introducir en la app Casa del iPhone cuando añadas el puente manualmente. Es el equivalente a escanear un código QR en un accesorio oficial, pero usando un código numérico.

Para que Homebridge se ejecute siempre al encender la Raspberry Pi, hay varias estrategias. Una sencilla consiste en instalar la herramienta screen (sudo apt-get install screen) y editar el archivo /etc/rc.local para que lance una sesión en segundo plano que arranque Homebridge automáticamente con una línea que ejecute screen -dmS homebridge homebridge bajo el usuario pi.

Con esa configuración, cada vez que la Pi arranque, Homebridge quedará corriendo en segundo plano dentro de una sesión screen, algo muy útil si gestionas la máquina por SSH. A partir de ahí, solo tendrás que editar el archivo config.json en /home/pi/.homebridge/config.json para ir añadiendo plugins y accesorios según tus necesidades.

Interfaz web y gestión de Homebridge

Aunque al principio Homebridge se manejaba casi solo por terminal, hoy en día la interfaz gráfica basada en navegador facilita enormemente la vida a cualquiera que empiece desde cero. Esta interfaz permite ver el estado del servidor, acceder al listado de plugins, revisar logs y modificar la configuración.

La interfaz incluye un panel de control con widgets personalizables en el que puedes ver de un vistazo si Homebridge está activo, cuántos accesorios están configurados, qué plugins están instalados y si hay actualizaciones disponibles. También permite lanzar copias de seguridad de la configuración y restaurarlas en caso de problemas.

Desde la sección de plugins puedes buscar entre los miles de complementos publicados por la comunidad, instalarlos con un clic y acceder a su documentación básica sobre configuración. Esto simplifica muchísimo el proceso de añadir compatibilidad con nuevas marcas sin tener que pelearte con npm a mano.

La interfaz también expone un editor para el archivo config.json de Homebridge, donde se define qué accesorios y plataformas están activos, sus credenciales de acceso, puertos, direcciones IP, etc. Aunque conviene ir con cuidado, realizar cambios desde aquí resulta más cómodo y seguro que andar editando el archivo por SSH.

Además, incluye opciones para reiniciar, detener o iniciar el servicio de Homebridge desde el propio panel, sin tener que entrar en la consola del sistema. Y si algo falla, la pestaña de logs permite ver en tiempo real los mensajes de error para averiguar qué plugin está dando guerra.

Plugins imprescindibles para ampliar las posibilidades de HomeKit

Una vez tengas Homebridge instalado y emparejado con HomeKit, llega lo divertido: añadir plugins para conectar dispositivos que antes eran “invisibles” para Siri. La comunidad mantiene más de 2.000 complementos, y cada uno está orientado a una familia concreta de dispositivos o servicios.

Uno de los más populares es el plugin Homebridge-Alexa, que permite controlar tus accesorios Homebridge desde altavoces inteligentes de Amazon. Gracias a él, puedes usar un Echo para manejar bombillas, regletas inteligentes, sensores de temperatura, persianas, puertas de garaje o cerraduras que en realidad están colgadas de HomeKit.

También destaca Homebridge-Nest-Cam, que hace posible integrar cámaras y timbres de la gama Nest de Google en HomeKit. Con este complemento, podrás recibir avisos cuando alguien pulse el timbre, cuando se detecte movimiento en la puerta, hablar con las personas que están al otro lado y ajustar opciones como el sonido de los timbres compatibles.

Para los usuarios de robots aspiradores Roomba, el plugin Homebridge-Roomba2 se ha vuelto casi obligatorio. Aunque estos aspiradores no sean oficialmente compatibles con HomeKit, con este plugin podrás arrancarlos, detenerlos, enviarlos a la base de carga y ver el estado de la batería, así como recibir notificaciones cuando el depósito esté lleno.

Otro complemento muy útil es Homebridge-Ring, que hace compatibles con HomeKit los timbres con vídeo, cámaras, luces inteligentes y sistemas de alarma de Ring. Esto te permite ver directamente en la app Casa quién está llamando, activar luces de exterior o integrar sensores de movimiento en automatizaciones complejas.

Finalmente, para aquellos con muchos mandos a distancia por infrarrojos o radiofrecuencia, el plugin Homebridge-Broadlink-RM permite emparejar dispositivos controlados por IR y RF a través de hubs como el Broadlink RM4 Pro. Así puedes manejar televisores, aires acondicionados, motores de persianas, proyectores o interruptores RF desde HomeKit, como si fueran accesorios nativos.

La clave, en todos los casos, es leer bien la documentación de cada plugin para saber qué datos de configuración necesitas introducir en el config.json (tokens de acceso, credenciales de la cuenta del fabricante, IP del dispositivo, etc.). A partir de ahí, los dispositivos aparecerán como accesorios estándar en la app Casa, listos para integrarse en escenas y automatizaciones.

Con todo este ecosistema alrededor, Homebridge se convierte en la pieza que falta para unificar tu casa inteligente en torno a HomeKit, permitiéndote mezclar sin problema accesorios oficiales de Apple con equipos pensados para Alexa o Google, y manteniendo un control centralizado desde tus dispositivos iOS.

Gracias a esta combinación de servidor ligero, interfaz web amigable y miles de plugins mantenidos por una comunidad muy activa, cualquier usuario con un mínimo de ganas puede, paso a paso, montar un sistema de domótica muy potente sin renunciar a Siri ni a la app Casa, y sin tener que limitarse solo a la corta lista de accesorios “oficiales” compatibles con HomeKit.