Documentación

Instalación

Nucleum Hub es una pequeña integración de Home Assistant. La instalas una vez, en tu Home Assistant, y aparece en la barra lateral de cada pantalla. Es un solo paquete: el panel, sus imágenes y la integración llegan juntos, y nunca copias un archivo a mano.

Antes de empezar

  • Home Assistant 2026.3 o posterior, en cualquier tipo de instalación: Home Assistant OS, Container, Core o Supervised.
  • Una cuenta de administrador, para la instalación y el primer arranque.
  • HACS, si quieres la vía de un clic. Sin él, usa el zip.
  • Internet para Home Assistant cuando añades la integración: con nuestro servidor se inicia tu prueba de 60 minutos.
  • Navegadores: Chrome / Edge 105+, Safari 16+, Firefox 121+. ¿No estás seguro de tu tableta? Abre antes en ella la demo.

1. Añade nuestro repositorio a HACS

Nucleum Hub no está en la lista predeterminada de HACS: añades nuestro repositorio a HACS como repositorio personalizado, una sola vez.

  • Con un clic: abre Añadir a HACS con My Home Assistant. Abre tu Home Assistant y pide a HACS que añada nuestro repositorio; confirma con Añadir.
  • A mano: en HACS, abre el menú ⋮ › Repositorios personalizados, pega https://github.com/iulianmara/nucleum-hub, elige el tipo Integración y pulsa Añadir.

2. Descarga y reinicia

  1. En HACS, abre Nucleum Hub y pulsa Descargar.
  2. Reinicia Home Assistant: Ajustes › Sistema › Reiniciar.

3. Añade la integración

Ajustes › Dispositivos y servicios › Añadir integración › Nucleum Hub y, después, Enviar. Nucleum Hub aparece en la barra lateral, en cada pantalla con sesión iniciada en tu Home Assistant, y empieza tu prueba de 60 minutos de reloj: todas las funciones, una vez por instalación de Home Assistant.

4. Pega tu clave de licencia

¿Has comprado una licencia? Tu clave te la enviamos nosotros por correo, justo después del pago.

  1. Abre Ajustes › Dispositivos y servicios › Nucleum Hub › Configurar.
  2. Pega la clave y confirma. Las mayúsculas, las minúsculas y los espacios no importan.
  3. La integración la activa una vez en línea y después la comprueba ella sola con nuestro servidor. Conserva el correo: solo guardamos una huella de la clave.

Casas sin internet, traslados y la instalación de pruebas: Licencia y activación.

Sin HACS: el zip

  1. Descarga el zip desde la última versión de nuestro repositorio en GitHub.
  2. Descomprímelo en la carpeta de configuración de tu Home Assistant, la que contiene configuration.yaml. Debe quedarte custom_components/wall_dashboard/.
  3. Reinicia Home Assistant y sigue los pasos 3 y 4 de arriba.

En Home Assistant OS, abre esa carpeta desde tu ordenador con el complemento Samba share, o con Studio Code Server. En Container y Core, es la carpeta que montaste o definiste como config. La carpeta wall_dashboard lleva el nombre técnico de la integración; en Home Assistant aparece como Nucleum Hub.

Abre Nucleum Hub en la barra lateral

Abre Nucleum Hub desde la barra lateral, con una cuenta de administrador. El asistente de configuración tiene tres pasos: tu idioma y un nombre para el saludo, las páginas que quieres y lo que encontró en tu casa (solar, red, batería, tiempo, alarma y más), que puedes corregir. Pulsa Crear panel.

Tu configuración se guarda en Home Assistant, no en el navegador: por eso todas las pantallas muestran lo mismo, y por eso tus copias de seguridad de Home Assistant la incluyen.

Después de una actualización, las pantallas que ya están abiertas muestran un botón Nueva versión: tócalo para cargar la nueva versión. Nunca se recargan solas.

En una tableta de pared

  • La dirección: abre http://homeassistant.local:8123/nucleum-hub, con la dirección de tu Home Assistant en lugar de homeassistant.local:8123, e inicia sesión una vez, con «Mantener la sesión iniciada».
  • Fully Kiosk Browser: usa la misma dirección como URL de inicio.
  • Sin la barra lateral de Home Assistant: en la tableta, abre tu perfil (tu nombre, abajo en la barra lateral) y activa la opción que oculta siempre la barra lateral (en inglés «Always hide the sidebar»). Solo vale para ese navegador; para quitarla, abre http://homeassistant.local:8123/profile en la tableta.

Los teléfonos con la app de Home Assistant, y un panel propio para cada pantalla: La app Companion y Fully Kiosk.

Si tu Home Assistant filtra el tráfico saliente

La integración solo habla con api.nucleumhub.com (licencia y prueba); las actualizaciones llegan desde GitHub, a través de HACS. Tus pantallas no hablan con ninguno de los dos.

Instalación manual, como último recurso

Solo si la integración no puede funcionar, o si nuestro soporte te lo pide. El panel es un solo archivo del paquete: custom_components/wall_dashboard/frontend/wall-dashboard.html.

  1. Cópialo, con la carpeta wall-dashboard-weather que está a su lado, en la carpeta www de tu carpeta de configuración. Si no había carpeta www, créala y reinicia Home Assistant.
  2. Ajustes › Paneles de control › Añadir panel de control › Página web, con la dirección /local/wall-dashboard.html.

Lee tu configuración desde Home Assistant, así que tus pantallas se ven igual. Las versiones nuevas llegan solo con la integración.