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

Home Assistant es una de las cosas más útiles que puedes ejecutar en una Raspberry Pi. Te permite controlar todos tus dispositivos inteligentes desde un solo lugar, con muchas opciones de personalización. Lo he configurado más veces de las que puedo contar, así que aquí tienes una guía clara, paso a paso, para ayudarte a hacerlo fácilmente también.

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

Voy a repasar ambos métodos de instalación, así que solo elige el que mejor funcione para tu configuración. Luego, te daré algunos consejos para comenzar de la manera correcta, sin importar qué método de instalación elijas. ¡Vamos a hacerlo!

Instalación de Home Assistant con imagen dedicada

Si tu Raspberry Pi estará dedicada únicamente a Home Assistant, utiliza este método de instalación. Será mucho más simple 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:

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

Explicaré cada paso en detalle a continuación.

Grabar Home Assistant en una tarjeta SD

Home Assistant es compatible oficialmente con Raspberry Pi 5, 4B y 3B, por lo que ofrece una imagen construida para ello.

Nota: Este método instalará la imagen de 64 bits de Home Assistant. Aún es posible encontrar una imagen de 32 bits con un poco de trabajo adicional, pero el soporte para ella ha llegado al final de su vida útil.

A continuación, te explico cómo grabar Home Assistant en una tarjeta SD:

• Descargar e instalar Raspberry Pi Imager, si aún no lo tienes.
  Raspberry Pi Imager es una herramienta gratuita para instalar fácilmente un nuevo sistema operativo, copiando el archivo de una imagen de sistema a la tarjeta SD.
• Insertar la tarjeta SD en tu PC.
  Probablemente necesitarás un adaptador de tarjeta SD/micro-SD.
  Y si no tienes un lector de tarjetas SD en tu PC, puedes comprar un adaptador USB como este. Lo usarás todo el tiempo con tu Raspberry Pi, así que vale la pena tener uno.
• Iniciar Raspberry Pi Imager y hacer las siguientes selecciones.
• Device – elige tu modelo de Pi.
• OS – Navega a Other specific-purpose OS > Home Automation > Home Assistant, y selecciona Home Assistant OS.
  
• Storage – selecciona tu tarjeta SD.
• Writing – haz clic en el botón “WRITE” para comenzar el proceso de grabación.

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 estás listo para iniciar Home Assistant por primera vez. Para facilitar las cosas, conecta tu Raspberry Pi a un cable de red antes de encenderla:

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

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

Solo espera un poco hasta que aparezca la interfaz de línea de comandos (CLI) de Home Assistant, y luego puedes ir directamente a la sección Getting Started with Home Assistant (omite la parte de Docker de este tutorial).

Nota: Recientemente tuve que configurarlo usando wifi, y no fue nada intuitivo. Aquí está lo que hice por si te ayuda. Comienza abriendo la CLI completa con:
login
Y luego puedes usar nmcli para configurar la conexión:
nmcli dev wifi connect 'YOUR-SSID' password 'YOUR-PASSWD'
Advertencia: la disposición del teclado predeterminada es QWERTY y parece que no hay forma de cambiar eso.

Instalación de Home Assistant con Docker

Si ya tienes otros servicios en tu Pi y quieres mantenerlos en funcionamiento, utiliza 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 agregarlo 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 en el momento de escribir esto (Trixie 64 bits), 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), tendrás que 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 Raspberry Pi, que es donde podrías perderte, así que responderé tus preguntas aquí.

• El paquete de Docker en el repositorio predeterminado para Raspberry Pi OS está desactualizado.
• La mejor manera de instalar Docker en Raspberry Pi OS es ejecutar este comando:
  curl -sSL https://get.docker.com | sh
  

No necesitas usar sudo, el script lo hará por ti. Básicamente, este comando agregará un nuevo repositorio a tus fuentes APT e instalará los paquetes desde allí. Cuando termine, Docker iniciará su servicio automáticamente e imprimirá la versión.

Si eres nuevo en esto, te recomiendo leer mi guía completa sobre Docker en Raspberry Pi primero. 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.

Método #1: a través del comando Docker

A continuación, la sintaxis del comando para lanzar Home Assistant con Docker a través de un comando:

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 largo, y necesitas ajustarlo para tu sistema:

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

En mi caso, solo usé este ejemplo:

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 obtienes este error: “docker: Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock”, asegúrate de haber seguido completamente nuestra guía de instalación.

Puedes solucionarlo ejecutando este comando, cerrando sesión y volviendo a iniciar sesión:
sudo usermod -aG docker $USER

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.

Método #2: a través de Docker Compose

Si te resulta más fácil gestionar contenedores a través de un archivo de texto persistente, puedes lanzar Home Assistant a través de Docker Compose en su lugar:

• Crear una carpeta de proyecto para Home Assistant:
  mkdir ~/HA
cd ~/HA
• Dentro de esa carpeta, crea un archivo compose.yaml:
  nano compose.yaml
• Pega las siguientes líneas:

services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - ./:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    restart: unless-stopped
    privileged: true
    network_mode: host
    environment:
      TZ: Europe/Amsterdam

• Cambia estas partes, si es necesario:
  • “Europe/Amsterdam” por tu zona horaria.
  • “./:config” se refiere al directorio actual. Puedes reemplazar la parte “./“ con una ruta diferente si deseas almacenar los archivos en otro lugar.
• Guardar y salir (CTRL+X).
• Lanzar el contenedor de Home Assistant:
  docker compose up

Ahora el contenedor se iniciará y la interfaz web debería estar disponible. Aprenderás cómo acceder a ella en la sección Getting Started with Home Assistant a continuación.

(Si quieres aprender más sobre cómo usar Docker Compose, consulta nuestra guía: La forma más fácil de ejecutar Docker en Raspberry Pi, en inglés)

Opcional: actualizar Home Assistant al usar 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 forma de actualizarlo parece ser eliminar el contenedor y crear uno nuevo con la nueva versión.

Aquí está el comando a 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 hora de conectarlo a todos tus dispositivos inteligentes y comenzar a divertirte con él!

Acceder a la Interfaz Web

Independientemente del método de instalación que elegiste, 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://IP_ADDRESS:8123.

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

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.
• Establecer 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 luego escaneará tu red y ofrecerá agregar rápidamente dispositivos inteligentes compatibles:
  
• Simplemente haz clic en el que deseas agregar, o haz 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).
• Agregar 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 agregar integraciones adicionales (como sitios web o cosas que no se han detectado automáticamente), pero recomiendo hacerlo una vez en la interfaz completa.

Una vez que completes este asistente de configuración inicial, deberías tener acceso a la interfaz completa, con un panel atractivo que incluye las integraciones que configuraste:

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

Agregar 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 agregar nuevos:

• Haz clic en Settings y luego en Devices & Services.
  
• Obtendrás la misma lista que durante el proceso de incorporación, pero también puedes agregar nuevas integraciones.
• Home Assistant es compatible con muchos servicios relacionados con la automatización del hogar.
  Aquí hay algunos ejemplos: sitios web de clima, dispositivos de red (Unifi, en inglés, Synology, …), servicios en la nube (Google, Apple, …), robots (aspiradoras), enchufes inteligentes (hogar, 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 obtendrás pasos adicionales dependiendo de la integración que desees agregar.
  Por ejemplo, para conectarte a una API de clima, generalmente necesitarás una clave API (a menudo puedes obtener una gratis, solo creando una cuenta en su sitio web).
  Para una aspiradora robot, probablemente necesitarás presionar un botón en ella, etc.

Intenta agregar 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, se encienden las luces en la sala y suena mi canción favorita). Pero incluso con unos pocos dispositivos y algunos servicios web adicionales, ya puedes construir paneles de control muy interesantes.

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í te explico cómo:

• Ve a Settings > Dashboards.
• Haz clic en el botón + Add Dashboard.
• Elige un título y un ícono:
  
• Luego haz 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 mostrar los datos de diferentes formas (botón, calendario, gráfico de historial, indicador, etc.).
  
• Después de elegir una plantilla, deberás seleccionar el valor exacto que quieres mostrar en ella.
  Por ejemplo, en mi panel de clima, puedo elegir mostrar la temperatura, precipitaciones, índice UV, etc.
  

Puede parecer complicado mientras lees esto, pero una vez que lo intentes, es bastante intuitivo. Así que 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 bonitos paneles 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, enciende el calefactor.
• Cuando se detecte movimiento en el dormitorio, enciende la luz de la pared.
• Si el viento supera los 60 km/h, cierra 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:

• Ve a Settings > Automation & Scenes.
• Haz clic en el botón + Create Automation.
• Cambia el nombre de la automatización por algo que puedas recordar fácilmente.
  Lo mejor es una sola frase que explique exactamente lo que hace.
• En la parte de desencadenantes, configura el dispositivo que se utilizará para iniciar la automatización.
• Luego establece el sensor y el valor de desencadenante exactos que iniciarán la automatización.
  Por ejemplo, probé con AccuWeather (servicio web de clima), y configuré que cuando la altura de las nubes esté por debajo de un cierto umbral, iniciará una automatización para encender las luces de la casa.
  Pero también puedes simplemente usar el desencadenante “Sol” y encender las luces al atardecer, por ejemplo.
  
• Puedes agregar condiciones en la siguiente sección si es necesario.
  Ejemplo simple: no enciendas la luz de la cocina si ya está encendida.
• Luego, establece las acciones que deben activarse cuando se cumplan las condiciones.
  En mi caso: enciende la luz de la cocina, por ejemplo.
  También puedes ajustar otras configuraciones como el brillo 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 intenta pensar en algo útil para tu hogar.

Video

Pensamientos finales

En general, Home Assistant es una de las mejores herramientas para un hogar inteligente con Raspberry Pi (en inglés). La instalación es bastante sencilla, y puedes hacer casi cualquier cosa con ella. La interfaz es intuitiva y solo se complica si intentas construir automatizaciones con múltiples dispositivos interconectados.

Si tienes dispositivos inteligentes, pero sientes que no son tan inteligentes y aún necesitas hacer muchas tareas manualmente, Home Assistant podría ser lo que falta en tu hogar. Podría ahorrarte dinero al evitar tener que comprar dispositivos específicos para lograr lo que quieres.

Intenta instalar Home Assistant y encuentra algunas formas de hacerlo útil, como estos proyectos de automatización del hogar fáciles (en inglés). Te dará 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 el tema), pero creo que Home Assistant es mi favorito actualmente.

Si estás usando Ubuntu en tu Raspberry Pi, o incluso en tu computadora, puedes consultar este otro artículo para obtener más detalles sobre esta distribución: Instalar Home Assistant en Ubuntu: Guía Paso a Paso (en inglés)