jueves, 15 de octubre de 2026

¿Instalamos HA? ¿Qué setup es más interesante?

Proceso de instalación

Puedes encontrar todo el proceso de instalación en la web oficial:
https://www.home-assistant.io/installation/

Ahí te explicarán todo el proceso de manera detallada, pero yo te explicaré básicamente las opciones disponibles.

Lo primero de todo es que tengas claro el dispositivo que vas a emplear para tu Home Assistant, y lo ideal es destinar un mini PC o una Raspberry Pi con bajo TDP.
Piensa que el equipo lo vamos a tener funcionando todo el día y no nos interesa un equipo con consumos muy altos o mala capacidad de disipación.

Opción 1: Setup con Raspberry Pi

Raspberry Pi → El TDP es bajísimo, entre 3 W y 7 W (dependiendo del modelo). Te aconsejo emplear como mínimo una Pi 3 B+. Yo hice pruebas con una Raspberry Pi 2 instalando su versión correspondiente; funcionar funciona, pero vas a tener limitaciones.

En la red vas a encontrar información y youtubers que te dicen que con la Pi 3 vas a estar limitado en cuanto a rendimiento y cantidad de dispositivos. Yo, en mi experiencia y lo que te puedo decir, es que durante meses he tenido el sistema funcionando instalado en una Pi 3 mediante Docker. Cero problemas respecto a la gestión de múltiples dispositivos de diferentes fabricantes, incluso en customización propia de sensorística con Arduino, ESP32 o Wemos.

Eso sí, en caso de usar Raspberry, es crítico no trabajar sobre la SD (que es lo que me ocurrió a mí, y por eso abandoné la opción de la Rapi a los meses). Un día dejó de funcionar HA, ya que se corrompió la memoria SD.
Así que, en caso de decantarte por Raspberry, instala siempre sobre USB o memoria externa.

A parte de esto, te voy a narrar algunos problemas que tuve en la instalación; no es que sean típicos, pero yo pasé por ellos, así que ¿por qué no compartirlo?

¿Qué problemas tuve para instalarlo y cómo lo hice?

En primer lugar, intenté varias instalaciones de Home Assistant directamente sobre la Raspberry Pi 3B, sin éxito, es decir, con la imagen recomendada.
El proceso era la carga de la imagen en la SD con Balena Etcher. Me arrancaba el SO de Home Assistant, pero se quedaba bloqueado en el proceso de instalación.


Intenté dar con el problema o error (que debía dejar en bucle el arranque) accediendo en modo consola a HA. Así que, si te ocurre, puedes hacer lo mismo.
Una vez en la CLI, comprobaremos el log del supervisor para verificar qué está ocurriendo.
Este es el error que me devolvía, por el cual no arrancaba el SO:

WARNING (MainThread) [supervisor.jobs] 'Updater.fetch_data' blocked from execution, no supervisor internet connection

Investigando en foros no encontré solución, así que decidí cambiar de estrategia para la instalación.

En segundo lugar, probé la instalación con Docker.

Esta instalación es la versión "Container" (sin Supervisor/Add-ons), suficiente para empezar; si algún día quieres los add-ons oficiales, se puede migrar con una copia de seguridad.

Para los comandos usaremos la terminal de la Raspberry Pi (en este caso no hace falta saber electrónica, solo seguir el orden).

Aquí te dejo los pasos a seguir para instalar en la Raspy:

  • Prepara la Raspberry Pi con Raspberry Pi OS de 64 bits

  • Actualiza el sistema

    • sudo apt update

    • sudo apt upgrade

  • Instala Docker

    • curl -sSL https://get.docker.com | sh

    • sudo usermod -aG docker pi (usar Docker sin sudo)

    • Reinicia la Raspberry Pi

  • Instala docker-compose

    • sudo apt-get install libffi-dev libssl-dev

    • sudo apt-get install -y python3 python3-pip

    • sudo pip3 install docker-compose

  • Crea las carpetas: mkdir domotica → cd domotica → mkdir ha → cd ha

  • Crea el archivo docker-compose.yml (nano docker-compose.yml)

    • Imagen: home-assistant:stable

    • Volumen ./config para la configuración

    • Guarda con Ctrl+O y sal con Ctrl+X

  • Lanza Home Assistant: docker-compose up -d

  • Abre en el navegador http://IP-de-tu-Raspberry:8123 y sigue el asistente inicial

Después de seguir el asistente tendrías que tenerlo en marcha; suele tardar un rato.

*docker-compose.yml es un pequeño archivo de texto donde se define cómo se instala Home Assistant; solo copias el contenido que da el tutorial y guardas.

Esa es la teoría, como si todo fuera bien, pero como en este mundo de la informática-electrónica no es así… ¿Qué me ocurrió?

No me permitía instalar Docker en la Raspberry, lanzando un error y remitiéndonos a la página de Docker.
Después de investigar en foros, al parecer el problema estaba en que la hora y fecha de la Raspberry estaban desfasadas y no actualizaba. Así que seguí estos pasos que encontré en foros:

  • Comprueba el estado del reloj: timedatectl (mira si dice System clock synchronized: no)

  • Activa la sincronización NTP: sudo timedatectl set-ntp true

  • Espera unos segundos y verifica: timedatectl (ahora debería decir synchronized: yes)

  • Si no sincroniza, reinicia el servicio: sudo systemctl restart systemd-timesyncd

En resumen: el reloj estaba mal y los certificados SSL "todavía no eran válidos". El fix fue un solo comando: sudo timedatectl set-ntp true, que activa la sincronización automática por NTP. En Raspbian el servicio equivalente es systemd-timesyncd, así que si no arranca: sudo systemctl restart systemd-timesyncd, y comprueba con timedatectl que ya dice synchronized: yes.
En caso de no solucionarlo así, prueba a reinstalar NTP, como última instancia:
https://forums.raspberrypi.com/viewtopic.php?t=171418

Después de la sucesión de problemas… retomamos la instalación de Docker.

¿Ahora no instala docker-compose con PIP? Solucionado con apt:

sudo apt install docker-compose

¡POR FIN! ¡FUNCIONANDO!

Extras: cómo actualizar Home Assistant en Docker

HA dejó de funcionar un día; se arranca la Rapsi en modo consola y nos lleva a la CLI, pero al parecer no inicializa HA. Se prueba a reinicializar HA y nos indica que está up-to-date.

Desde el modo consola accedemos a la carpeta donde tenemos el docker-compose.yml, en este caso domotica/ha.

  • Hacemos un docker-compose pull → bajará la última actualización

  • Después paramos Home Assistant: docker-compose down

  • Reiniciamos HA: docker-compose up -d


  • Como consejos:

  • No actualices a la última versión el primer día que la la liberen; espera unos días a que la comunidad reporte incidencias en el foro. ;)

  • Copia de seguridad antes de actualizar: aunque Docker no tiene los backups del Supervisor, puedes respaldar la carpeta config (por ejemplo con tar o con rsync a un NAS) antes de cada actualización. Si algo va mal, restauras y listo.

     

Opción 2: Setup con mini PC o NUC


Mini PC o NUC →

Opté por cambiar a un mini PC y compré un NUC i3 de segunda mano. Si lo haces así te recomiendo una vez que te llegue abrirle para limpiar toda la suciedad y polvo que pueda tener interior, así como cambiar la pila del reloj.

Este es mi modelo.


Veamos ahora unos consejos iniciales para usar el NUC.

1. Elige el método de instalación adecuado

  • Home Assistant OS (bare-metal): la opción más sencilla y recomendada si el NUC se dedicará exclusivamente a domótica. Obtienes control total del hardware, menor consumo de recursos y acceso directo a la tienda de complementos (Add-ons).

  • Virtualización con Proxmox VE: la alternativa ideal si quieres aprovechar la potencia del NUC para ejecutar más servicios (n8n, Plex, Pi-hole, NAS ligero). Permite crear una máquina virtual (VM) con HAOS mediante scripts de la comunidad y facilita enormemente las copias de seguridad de la máquina completa.

2. Configuración previa de la BIOS/UEFI

  • Arranque tras corte de luz: entra en la BIOS y activa la opción AC Power Recovery o State After G3 en Power On (o Last State). Así el NUC se encenderá automáticamente si hay un corte eléctrico.

  • Modo de arranque: configura el arranque exclusivamente en modo UEFI (desactiva Legacy boot).

  • Virtualización: si vas a usar Proxmox o cualquier hipervisor, asegúrate de activar Intel VT-x e Intel VT-d.

  • Secure Boot: desactívalo temporalmente si te da problemas al flashear la imagen de HAOS o al arrancar desde USB.

3. Red y conectividad

  • Conexión cableada: conecta siempre el NUC por cable Ethernet. Evita el Wi-Fi para el servidor domótico principal, ya que la estabilidad de los eventos en tiempo real depende de la red.

  • IP estática: asigna una IP fija desde el panel de administración del router (DHCP Reservation) vinculada a la dirección MAC del NUC.

4. Dongles y adaptadores (Zigbee / Z-Wave / Thread)

  • Usa siempre un alargador USB: si vas a conectar un coordinador Zigbee/Thread (como un Sonoff o SkyConnect), conéctalo con un alargador de al menos 1 metro. Los puertos USB 3.0 del NUC generan interferencias electromagnéticas severas en la frecuencia de 2,4 GHz que degradan la red domótica.

  • Puertos USB 2.0: si el NUC dispone de ellos, prioriza conectar los dongles en puertos USB 2.0.

5. Copias de seguridad y mantenimiento

  • Estrategia de backups externos: configura desde el primer momento copias de seguridad automáticas hacia la nube o un almacenamiento de red (con add-ons como Google Drive Backup o Samba Backup). Nunca guardes los respaldos únicamente dentro del propio disco del NUC.

  • Unidad SSD: utiliza un disco SSD M.2/SATA con buen margen de vida útil (evita tarjetas microSD o unidades USB externas para el sistema base).

Lleva funcionando en torno a 2 años perfectamente. Ni limitaciones por dispositivos, ni fallos en HA.
La instalación, en este caso, ha sido del SO HA sobre el disco duro(64Gb) del mini PC.

Como extra le he puesto un coordinador Zigbee, ya que en las primeras ocasiones la mayor parte de los sensores empleados eran Wi-Fi, pero esto al final te acaba saturando mucho la red de casa.


Aquí te dejo los pasos a seguir para hacer la instalación con HAOS:

Paso 1: la BIOS, mi particular campo de minas

Lo primero que hice fue meterme en la BIOS. Para ello, enciendes el NUC y machacas la tecla F2 mientras arranca (en otros equipos puede ser Del, F1 o F10, ya sabéis, cada fabricante a lo suyo).

Dentro tuve que asegurarme de dos cosas:

  • Activar el arranque en modo UEFI.
  • Desactivar Secure Boot.

Guardas cambios, sales, y a por el siguiente paso. Fácil, ¿no? Pues sí, cuando sabes que hay que hacerlo, jeje.

Paso 2: escribir la imagen de HAOS en el disco

Aquí viene lo importante, y no lo digo solo por lo que vais a leer ahora: esta instalación borra todo lo que haya en el disco del NUC. Lo que tengas allí, se va a mejor vida. Yo tuve suerte porque era un equipo de segunda mano que usaba exclusivamente para esto, pero si vuestro caso es otro, haced copia de seguridad antes, que luego no digáis que no avisé.

La web oficial recomienda hacerlo arrancando Ubuntu desde un USB, y así lo hice yo:

  1. Preparé un USB de instalación de Ubuntu Desktop (mínimo 8 GB).
  2. Arranqué el NUC desde ese USB (en mi caso con F10 para elegir el dispositivo de arranque) y seleccioné Try Ubuntu. Y ojo a esto: Try, no Install. Si eliges Install, luego te pasa como a mí, que al intentar restaurar la imagen me saltaba un error de "target is busy". Ubuntu se estaba ejecutando desde el disco interno. Tuve que repetir el arranque y elegir la opción correcta.
  3. Con el equipo conectado a internet, descargué la imagen de HAOS para Generic x86-64 desde la propia documentación oficial.
  4. Abrí la aplicación Disks de Ubuntu, seleccioné el disco interno del NUC, menú de los tres puntos → Restore Disk Image…, elegí la imagen descargada y Start Restoring.
  5. Cuando terminó, apagué el equipo, quité el USB, y a rezar.

Os dejo también el plan B por si os resulta más cómodo y más sencillo: 

Si tienes el disco conectado a otro ordenador o con un adaptador USB-SATA, puedes grabar la imagen directamente con Balena Etcher (sí, el mismo que usaba para las SD de la Raspberry, qué tiempos aquellos). Descargas la imagen, la extraes, Flash from file → eliges el disco → Flash. Luego instalas el disco en el NUC y listo!!!!!

Paso 3: el primer arranque

Conecté el cable Ethernet (importante: por cable, nada de Wi-Fi, ya os contaré en otra entrada por qué), encendí el NUC y esperé. Si conectáis un monitor, tras un minuto aparece el banner de bienvenida de Home Assistant en consola, y es una vista preciosa, no os digo más.

En unos minutos, desde el navegador de vuestro PC o móvil, podéis entrar en http://homeassistant.local:8123. Si no responde (a mí me pasó alguna vez), probad con http://homeassistant:8123 o directamente con la IP del equipo, tipo http://192.168.1.X:8123. Lo típico: mágico cuando funciona, misterioso cuando no.

Ah, y no os asustéis si tarda un poco en el primer arranque: la instalación recién escrita no trae todos los componentes, y se descarga la última versión de Home Assistant Core la primera vez que arranca. Paciencia, que internet hace el resto.

¿Y si el equipo no encuentra nada arrancable?

Esto también me pasó, y como siempre, ¿por qué no compartirlo? El NUC me decía que no encontraba ningún medio arrancable. Resulta que faltaba la entrada EFI en la BIOS. La solución, desde un Ubuntu live, es crearla a mano:

bash
sudo efibootmgr --create --disk /dev/sda --part 1 --label "HAOS" --loader '\EFI\BOOT\bootx64.efi'

Si vuestro disco es un SSD NVMe, cambiad sda por nvme0n1. En la mayoría de BIOS también podéis añadir la entrada a mano desde el menú de arranque, indicando la ruta \EFI\BOOT\bootx64.efi.



Un poquito de información complementaria

¿Por qué se corrompe la tarjeta SD?

Las tarjetas SD tienen un número limitado de ciclos de escritura, y Home Assistant escribe constantemente en el disco: base de datos de eventos (SQLite por defecto), historiales, logs… Sobre todo si el sistema se apaga de forma brusca (un corte de luz sin SAI), el sistema de archivos puede corromperse con facilidad. Por eso:

  • Si usas Raspberry, instala el sistema en un SSD por USB (más fiable y mucho más rápido que la SD).

  • Alternativa: mantener la SD pero mover la base de datos y los logs a un disco externo, o aligerar el recorder.

  • Un SAI (UPS) pequeño conectado al equipo evita la mayoría de corrupciones por apagones. Pero esto es solo para los que son muy frikis jeje.

  • El mismo consejo aplica a los mini PC: usa SSD (M.2 o SATA), evita si puedes memorias USB como disco de sistema.


Aquí te dejo una tabla que he pedido de comparación a la IA para simplificar un poco la diferencia entre instalar HAOS o usar Docker.

HAOS vs. Docker (Container): qué elige cada uno

Home Assistant OS (HAOS)

Docker (Container)

Add-ons oficiales (tienda)

✅ Sí

❌ No (hay que montarlos aparte)

Supervisor / actualizaciones gestionadas

✅ Sí

❌ Manual (docker-compose pull)

Comparte equipo con otros servicios

Difícil (equipo dedicado)

✅ Fácil (junto a Plex, Pi-hole, n8n…)

Recurso más usado en mini PC / Proxmox

✅

También habitual

Control total del entorno

Menor

✅ Total (eres quien gestiona Docker)

En resumen: si el equipo va a ser exclusivo para domótica, HAOS; si quieres convivir con más servicios o aprender Docker por el camino, Container.

Zigbee vs. Wi-Fi para sensores 

Como dije antes, empezar con sensores Wi-Fi baratos (Tasmota, Tapo, Shelly…) puede acabar saturando la red. Por eso por lo general la comunidad recomienda Zigbee para sensores:

  • Los sensores Zigbee no usan tu Wi-Fi: forman su propia red de malla (cada dispositivo alimentado por red actúa de repetidor), así que no saturan el router.

  • Consumo mínimo: los sensores de temperatura o apertura a batería duran meses o años con una pila de botón; los equivalentes Wi-Fi requieren alimentación constante.

  • Funciona sin internet: si se cae la conexión, la red Zigbee sigue operativa.

  • Conviene eso sí: no mezclar demasiados dispositivos en el canal Zigbee ocupado por tu Wi-Fi (conviene separar canales para evitar interferencias entre ambas redes de 2,4 GHz).


Este por ejemplo es uno de mis primeros sensores "Custom". En las próximas publicaciones subiré información sobre él. Está compuesto por: un Weemos D1 mini, Funduino para medir resistividad de la tierra y un sensor AHT20(Temperatura y humedad). No tiene un consumo muy elevado el conjunto, pero mucho mayor que los de tipo Zigbee.



Consumos orientativos de hardware común en el Setup

  • Raspberry Pi 3/4/5: 3–7 W (TDP mínimo de la familia).

  • Mini PC Intel NUC : 6–15 W en reposo (los N100 modernos son especialmente eficientes).

  • Insisto, un mini PC de segunda mano (i3/i5 de 6ª-8ª generación) cuesta poco más que una Raspberry Pi 5 completa con caja y alimentación, y ofrece mucho más rendimiento y disco SSD nativo — la razón por la que la mayoría migramos de Pi a NUC.

No hay comentarios:

Publicar un comentario