🏠 docker-homebridge

Servidor Homebridge con Docker Compose

Este repositorio contiene la configuración de Docker Compose para desplegar Homebridge, una solución ligera que permite integrar dispositivos inteligentes no compatibles con Apple HomeKit, creando un puente (bridge) entre tu ecosistema domótico y HomeKit.

---

✨ Características de Homebridge

• Integración con Apple HomeKit: Añade dispositivos que no son compatibles de forma nativa.
• Interfaz web (Config UI X): Gestiona plugins, usuarios y configuraciones desde un panel web amigable.
• Plugins y extensiones: Soporte para miles de complementos desarrollados por la comunidad.
• Logs y monitorización: Registro de actividad accesible desde la interfaz.
• Despliegue simple y persistente: Configuración lista para usar con Docker Compose.

---

🚀 Instalación y Despliegue Rápido

1. Prerrequisitos

Asegúrate de tener instalados:

• Docker
• Docker Compose

---

2. Archivo de Configuración (docker-compose.yml)

Crea o copia el siguiente contenido en tu archivo docker-compose.yml:

services:
  homebridge:
    image: homebridge/homebridge:latest
    restart: always
    network_mode: host
    volumes:
      - ./volumes/homebridge:/homebridge
    logging:
      driver: json-file
      options:
        max-size: '10m'
        max-file: '1'
    healthcheck:
      test: curl --fail localhost:8581 || exit 1
      interval: 60s
      retries: 5
      start_period: 300s
      timeout: 2s

---

3. Despliegue del Contenedor

Desde el directorio donde guardaste el archivo docker-compose.yml, ejecuta:

docker compose up -d

Esto descargará la imagen de Homebridge y levantará el contenedor en segundo plano.
Para comprobar su estado:

docker ps

---

🌐 Acceso a la Interfaz Web

Una vez iniciado el contenedor, abre en tu navegador:

http://<DIRECCION_IP_DE_TU_SERVIDOR>:8581

La interfaz web de Homebridge Config UI X estará disponible allí.
Desde ella podrás gestionar:

• Plugins instalados
• Configuración del bridge
• Usuarios y backups

---

⚙️ Persistencia de Datos

Los datos del contenedor se almacenan en el volumen:

./volumes/homebridge:/homebridge

Esto incluye configuraciones, plugins, logs y credenciales, asegurando que no se pierdan al reiniciar el contenedor o el servidor.

---

🧰 Mantenimiento y Logs

Para ver los logs del contenedor en tiempo real:

docker logs -f homebridge

Para reiniciar Homebridge:

docker restart homebridge

---

🔒 Seguridad y Recomendaciones

• Cambia las credenciales de acceso por defecto en la interfaz web.
• Si expones el servicio a Internet, usa un proxy inverso con HTTPS (como Nginx o Traefik).
• Realiza copias de seguridad periódicas de la carpeta volumes/homebridge.

---

📚 Recursos Útiles

• 🌍 Sitio oficial: https://homebridge.io
• 📘 Documentación: https://github.com/homebridge/homebridge/wiki
• 🧩 Plugins: https://www.npmjs.com/search?q=homebridge-plugin