Primeros Pasos con Home Assistant en Raspberry Pi (2 Formas)

El Instalar Home Assistant es un proyecto popular para cualquier propietario de Raspberry Pi. Una vez que está conectado a tu configuración, Home Assistant puede controlar todos tus dispositivos inteligentes desde una sola interfaz. En este tutorial, te mostraré cómo ponerlo en marcha para que puedas disfrutar de la automatización del hogar.

Home Assistant está disponible como una imagen instalable para Raspberry Pi que puede ser grabada en una tarjeta SD como un sistema completo. También está disponible como un contenedor de docker, lo que hace posible usar Home Assistant junto con otros servicios en el mismo sistema.

Te explicaré ambos métodos de instalación, así que elige el que sea mejor para tu configuración. Después, te daré algunos consejos para empezar de la manera correcta, sin importar el método de instalación que hayas elegido. ¡Vamos allá!

Instalación de Home Assistant con Imagen Dedicada

Si tu Raspberry Pi se dedicará exclusivamente a Home Assistant, utiliza este método de instalación. Será mucho más sencillo a largo plazo.

Realizarás los mismos pasos que haces para grabar cualquier imagen de sistema operativo en tu Pi. Aquí tienes un resumen de cómo instalar Home Assistant en Raspberry Pi:

• Flashear la imagen en una tarjeta SD con Raspberry Pi Imager.
• Insertar la tarjeta SD en la Raspberry Pi.
• Arrancar en Home Assistant

Te voy a explicar cada paso en detalle a continuación.

Flashear Home Assistant en una tarjeta SD

Home Assistant oficialmente soporta las Raspberry Pi 5, 4B y 3B, por lo que ofrece una imagen construida para ellas.

Nota: Este método instalará la imagen de 64 bits de Home Assistant. Todavía es posible encontrar una imagen de 32 bits con algo de trabajo extra, pero el soporte para ella ha llegado a su fin.

Aquí está cómo flashear Home Assistant en una tarjeta SD:

• Descargar e instalar Raspberry Pi Imager, si no lo tienes ya.
  Raspberry Pi Imager es una herramienta gratuita para instalar fácilmente un nuevo OS, copiando el archivo desde una imagen del sistema a la tarjeta SD.
• Insertar la tarjeta SD en tu computadora.
  Probablemente necesitarás un adaptador de tarjeta SD/MicroSD.
  Y si no tienes un lector de tarjetas SD en tu computadora, puedes comprar un adaptador USB como este. Lo usarás todo el tiempo con tu Raspberry Pi, así que vale la pena tener uno.
• Lanzar Raspberry Pi Imager
• Seleccionar estas opciones:
  • Raspberry Pi Device: elige el modelo de tu Pi.
  • Sistema Operativo: Ir a Other specific-purpose OS > Home assistants and home automation > Home Assistant > Home Assistant OS
    
  • Almacenamiento: apunta a tu tarjeta SD
• Hacer clic en Next. Imager te advertirá que todo en tu tarjeta SD será borrado. Pulsa YES.
  

Imager comenzará a escribir en tu tarjeta SD. Después de unos minutos, debería estar listo, y puedes expulsar la tarjeta SD de tu computadora.

Primer arranque con Home Assistant

Ahora si estás listo para iniciar Home Assistant por primera vez. Para facilitarte las cosas, por favor conecta tu Raspberry Pi a un cable de red (en inglés) antes de encenderlo:

• Insertar la tarjeta SD en tu Raspberry Pi.
• Asegúrate de que todo lo demás esté conectado (especialmente la red y el monitor).
• Encenderlo y esperar unos minutos.

Home Assistant crea una interfaz web para que gestiones todo, así que no necesitas hacer nada directamente en el monitor, excepto tomar nota de la URL.

Solo espera un poco para que aparezca el CLI de Home Assistant, y luego puedes pasar a la sección de Getting Started with Home Assistant (omite la parte de Docker de este tutorial).

Instalación de Home Assistant con Docker

Si ya tienes otros servicios en tu Pi y quieres mantenerlos en funcionamiento, usa este método en su lugar. Instalar Home Assistant con Docker es una gran opción si ya tienes Raspberry Pi OS (u otra distribución) en funcionamiento y quieres añadirlo como si fuera una aplicación adicional.

Actualizar tu sistema

Estoy probando esta configuración en la última versión de Raspberry Pi OS disponible al momento de escribir (Bookworm 64-bit), pero debería funcionar en cualquier distribución similar a Debian. Si estás usando otros sistemas Linux como Manjaro o Arch (en inglés), necesitarás adaptar algunos de estos comandos.

Para evitar problemas durante la instalación, asegúrate de que tu sistema esté actualizado primero:
sudo apt update
sudo apt upgrade

Si hay muchos paquetes actualizados, se recomienda reiniciar antes de continuar:
sudo reboot

Instalar Docker en Raspberry Pi

La documentación oficial no explica cómo configurar Docker en la Raspberry Pi, donde podrías perderte, así que responderé tus preguntas aquí.

• Docker no está disponible en el repositorio APT en Raspberry Pi OS.
• La forma más fácil de instalar Docker en Raspberry Pi es usar este comando:
  curl -sSL https://get.docker.com | sh
  

No necesitas usar sudo, el script lo hará por ti. Básicamente, este comando añadirá un nuevo repositorio a tus fuentes APT, e instalará los paquetes desde allí.

Si eres nuevo en esto, te recomiendo leer primero mi guía completa sobre Docker en Raspberry Pi. Solo para asegurarte de que entiendes lo que estás haciendo aquí.

Crear un contenedor Docker para Home Assistant

Ahora que Docker está configurado en tu sistema, puedes seguir la documentación y crear un nuevo contenedor con Home Assistant.

Aquí está la sintaxis del comando para hacerlo:

docker run -d \
--name homeassistant \
--privileged \
--restart=unless-stopped \
-e TZ=MY_TIME_ZONE \
-v /PATH_TO_YOUR_CONFIG:/config \
--network=host \
ghcr.io/home-assistant/home-assistant:stable

Sí, ese es un comando grande, y necesitas ajustarlo para tu sistema:

• Reemplazar MY_TIME_ZONE con tu zona horaria actual. El formato es País/Ciudad.
  Por ejemplo: TZ=Europe/Paris (Puede que encuentres tu zona horaria rápidamente escribiendo el comando “timedatectl”)
• Reemplazar PATH_TO_YOUR_CONFIG con la carpeta donde quieras almacenar los archivos de configuración.

En mi caso, solo usé este comando:

docker run -d \
--name homeassistant \
--privileged \
--restart=unless-stopped \
-e TZ=Europe/Paris \
-v /home/pat/hass:/config \
--network=host \
ghcr.io/home-assistant/home-assistant:stable

Nota: Si recibes este error: “docker: Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock”

Puedes solucionarlo con:
sudo chmod 666 /var/run/docker.sock

Después de ejecutar este comando, el contenedor se iniciará y la interfaz web estará disponible. Aprenderás cómo acceder a ella en la sección Getting Started with Home Assistant a continuación.

Opcional: Actualizar Home Assistant cuando se usa Docker

Actualizar Home Assistant con el método de instalación de Docker es un poco complicado. No puedes simplemente ejecutar apt upgrade y esperar que se mantenga actualizado. Después de leer la documentación, la única manera de actualizarlo parece ser eliminar el contenedor y crear uno nuevo con la nueva versión.

Aquí está el comando para ejecutar (en este orden):
sudo docker pull ghcr.io/home-assistant/home-assistant:stable
sudo docker stop homeassistant
sudo docker rm homeassistant

Luego, puedes usar el mismo comando que durante la instalación para recrear el contenedor. Asegúrate de usar la misma ruta para la carpeta de configuración si no quieres empezar desde cero.

Comenzar con Home Assistant

Una vez que Home Assistant está instalado, es el momento de conectarlo a todos tus dispositivos inteligentes y empezar a divertirte con ello!

Acceder a la Interfaz Web

Cualquiera sea el método de instalación que hayas escogido, Home Assistant iniciará una interfaz web en el puerto 8123 de tu Raspberry Pi. Generalmente puedes acceder a ella con http://homeassistant.local:8123 o http://DIRECCIÓN_IP:8123.

Puedes consultar este artículo en cómo encontrar la dirección IP de tu Raspberry Pi si aún no la sabes.

Deberías obtener un formulario, como se ve en la captura de pantalla anterior, pidiéndote que crees la primera cuenta de usuario.

Luego se te harán algunas preguntas para personalizar tu configuración:

• Dar un nombre a tu instalación de Home Assistant.
• Configurar tu ubicación, zona horaria, sistema de unidades y moneda.
• Marcar las casillas correspondientes a la recopilación de datos que deseas compartir (o saltar esta pantalla).
• El asistente escaneará entonces tu red y ofrecerá añadir rápidamente los dispositivos inteligentes compatibles:
  
• Simplemente hacer clic en el que deseas añadir o hacer clic en “Finish” para hacerlo más tarde.
  En mi caso, detectó la mayoría de los que estaban conectados durante la instalación (luces, enchufes inteligentes y NAS).
• Añadir cada dispositivo puede requerir pasos adicionales. Por ejemplo, para las luces Philips Hue, necesitas presionar el botón en el hub para permitir que Home Assistant lo controle, y luego asignar cada luz a una habitación.
• Obviamente puedes hacer clic en “More” para añadir integraciones adicionales (como sitios web o cosas que no se han detectado automáticamente), pero recomiendo hacer esto una vez en la interfaz completa.

Una vez que este asistente de configuración esté completo, deberías tener acceso a la interfaz completa, con un agradable tablero incluyendo las integraciones que configuraste:

Ahora puedes usar esta interfaz para gestionar tus dispositivos inteligentes. Por ejemplo, puedo encender o apagar la luz de la cocina haciendo clic en el botón correspondiente. Pero Home Assistant va mucho más allá de eso.

Añadir más integraciones

Primero, asegúrate de configurar todos tus dispositivos inteligentes en esta interfaz. Puedes usar el elemento Settings en el menú de la izquierda para añadir nuevos:

• Hacer clic en Settings and then Devices & Services.
  
• Tendrás la misma lista que durante el proceso de incorporación, pero también puedes añadir nuevas integraciones.
• Home assistant es compatible con muchos servicios relacionados con la automatización del hogar.
  Aquí tienes algunos ejemplos: sitios web de clima, dispositivos de red (Unifi, en inglés, Synology, …), servicios en la nube (Google, Apple, …), robots (aspiradora), enchufes inteligentes (casa, coche, …), etc.
  Obtendrás la lista completa cuando hagas clic en “Add Integration”—es increíble todas las cosas que puedes monitorear y usar en tus automatizaciones.
• Luego tendrás pasos adicionales dependiendo de la integración que quieras añadir.
  Por ejemplo, para conectarte a una API de clima, generalmente necesitarás una clave API (a menudo puedes obtener una gratis, simplemente creando una cuenta en su sitio web).
  Para una aspiradora robot, probablemente necesitarás presionar un botón en ella. Etc.

Intenta añadir algunas integraciones. Home Assistant se convierte en un proyecto emocionante cuando tienes muchos dispositivos inteligentes y puedes hacer que trabajen juntos creando algunas automatizaciones (ej: cuando abro la puerta, enciende las luces en la sala de estar y reproduce mi canción favorita). Pero incluso con unos pocos de ellos y servicios web adicionales, ya puedes construir algunos bonitos paneles.

Crear un Nuevo Panel

Por defecto, Home Assistant creará un panel básico llamado “Overview” y otro llamado “Energy.” Pero puedes editarlos, eliminarlos o crear nuevos. Aquí está cómo hacerlo:

• Ir a Settings > Dashboards.
• Hacer clic en el botón + Add Dashboard.
• Elegir un título y un ícono:
  
• Luego hacer clic en el Panel que has creado en el menú de la izquierda para abrirlo.
• Ahora puedes hacer clic en el menú de la esquina superior derecha y elegir “Edit Dashboard” para personalizarlo.
• Desde allí, puedes hacer todo lo que quieras: agregar nuevas tarjetas, eliminar algunas, mover las existentes hacia arriba y hacia abajo, etc.
• Para cada tarjeta, hay muchas plantillas que puedes usar para formatear los datos de manera diferente (button, calendar, history graph, gauge, etc.).
  
• Después de elegir una plantilla, necesitarás elegir el valor exacto que deseas mostrar en ella.
  Por ejemplo, en mi panel meteorológico, puedo elegir mostrar la temperatura, precipitación, índice UV, etc.
  

Puede que pienses que es complicado al leer esto, pero una vez que lo intentes, es bastante intuitivo. Estoy seguro de que entenderás todo rápidamente. Comienza con algo que realmente quieras tener en tu panel, y encuentra la mejor manera de mostrar el valor.

Crear Tu Primera Automatización

Obviamente, Home Assistant no es solo una forma de tener paneles bonitos y reemplazar varias aplicaciones con una. También es la forma más efectiva de automatizar tu hogar.

La automatización es un proceso que se ejecutará automáticamente cuando se detecte un desencadenante:

• Si la temperatura interior baja de 20 °C, encender el calentador.
• Cuando se detecte movimiento en el dormitorio, encender la luz de la pared.
• Si el viento supera los 60 km/h, cerrar las persianas.
• Etc.

Crear una automatización no es complicado una vez que entiendes la idea. Encuentra algo simple que quieras probar, y sigue estos pasos para configurarlo:

• Ir a Settings > Automation & Scenes.
• Hacer clic en el botón “+ Create Automation.
• Cambiar el nombre de la automatización a algo que recuerdes.
  Una frase diciendo exactamente lo que hace es lo mejor.
• En la parte de desencadenantes, establecer el dispositivo que se usará para comenzar la automatización.
• A continuación, establecer el sensor y el valor exacto del desencadenante que iniciarán la automatización.
  Por ejemplo, probé con AccuWeather (un servicio web de clima), y dije que cuando el techo de nubes esté por debajo de cierto umbral, comenzará una automatización para encender la casa.
  Pero tú puedes simplemente usar el desencadenante “Sun”, y encender las luces al atardecer, por ejemplo.
  
• Puedes agregar condiciones en la siguiente sección si es necesario.
  Ejemplo simple: no encender la cocina si la luz ya está encendida.
• Luego, establece las acciones que deben activarse cuando se cumplan las condiciones.
  En mi caso: Encender la luz de la cocina, por ejemplo.
  También puedes ajustar otras configuraciones como la intensidad de las luces, etc.

Intenta crear algo simple primero y verifica si funciona. Dependiendo de los dispositivos inteligentes y las integraciones que configures, esto será más o menos fácil de probar. Las posibilidades son infinitas, solo trata de pensar en algo útil para tu casa.

Video

Reflexiones Finales

En general, Home Assistant es una gran aplicación. La instalación es bastante sencilla y puedes hacer casi cualquier cosa con ella. La interfaz es intuitiva, solo se complica si intentas desarrollar automatizaciones complejas con múltiples dispositivos inteligentes interconectados.

Si tienes dispositivos inteligentes, pero te parece que no son tan inteligentes, y todavía necesitas hacer muchas tareas manualmente, Home Assistant podría ser lo que falta en tu hogar. Intenta instalarlo y encuentra algunas formas de hacerlo útil, tendrás una excusa para pasar más tiempo en tu Raspberry Pi :-).

Domoticz (en inglés) y HOOBS (en inglés) son alternativas a considerar (haz clic en los enlaces para leer mis artículos sobre ellos), pero creo que Home Assistant es mi favorito actualmente.

Si estás usando Ubuntu en tu Raspberry Pi, o incluso en tu computadora, puedes revisar este otro artículo para obtener más detalles de esta distribución: Install Home Assistant on Ubuntu: A Step-by-step guide (en inglés)