Instalación de Home Assistant en Debian 13

¿Qué es Home Assistant?

Home Assistant es una plataforma de domótica de código abierto que nos permite controlar y automatizar todos los dispositivos inteligentes del hogar (luces, enchufes, sensores, cámaras, termostatos…) desde un único panel, con la ventaja de que la información se queda en local y no depende de la nube del fabricante. Soporta cientos de integraciones y permite crear automatizaciones tan sencillas o complejas como queramos.

Existen varias formas de instalarlo. En este tutorial usaremos Home Assistant Container, es decir, Home Assistant ejecutándose como contenedor Docker sobre Debian 13. Es la opción ideal cuando ya tenemos un servidor Debian y queremos convivir con otros servicios, aunque tiene la particularidad de que no incluye los add-ons del sistema operativo Home Assistant OS.

Requisitos

• Debian 13 instalado y actualizado.
• El puerto 8123 libre en el host (interfaz web de Home Assistant).
• Privilegios de sudo o root.

Instalar Docker

Añadimos el repositorio oficial de Docker e instalamos el motor con el plugin de Compose:

root@homeassistant:~# apt update
root@homeassistant:~# apt install -y ca-certificates curl
root@homeassistant:~# install -m 0755 -d /etc/apt/keyrings
root@homeassistant:~# curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
root@homeassistant:~# chmod a+r /etc/apt/keyrings/docker.asc
root@homeassistant:~# echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian trixie stable" > /etc/apt/sources.list.d/docker.list
root@homeassistant:~# apt update
root@homeassistant:~# apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
root@homeassistant:~# systemctl enable --now docker

Desplegar Home Assistant

Creamos un directorio para el despliegue y un fichero docker-compose.yml:

root@homeassistant:~# mkdir -p /opt/homeassistant && cd /opt/homeassistant

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

Algunas notas sobre esta configuración:

• network_mode: host es la opción recomendada por el proyecto: Home Assistant necesita acceso directo a la red para descubrir dispositivos (mDNS, DHCP, etc.). Por eso no declaramos ports: el servicio escuchará directamente en el 8123 del host.
• ./config guarda toda la configuración, la base de datos y las automatizaciones, de modo que sobreviven a la recreación del contenedor.
• TZ fija la zona horaria, importante para que las automatizaciones basadas en horas funcionen correctamente.

Levantamos el contenedor:

root@homeassistant:/opt/homeassistant# docker compose up -d
root@homeassistant:/opt/homeassistant# docker compose logs -f

La primera vez tarda un poco en arrancar mientras genera la configuración inicial dentro de ./config.

Configuración inicial (onboarding)

Abrimos en el navegador http://10.10.10.14:8123. Nos recibe el asistente de bienvenida de Home Assistant.

Pulsamos en Crear mi hogar inteligente y rellenamos los datos de la cuenta de administrador: nombre, nombre de usuario y contraseña. Esta cuenta es la que usaremos para administrar la instalación, así que conviene elegir una contraseña fuerte y guardarla bien.

El asistente completa el resto de pasos (ubicación, unidades y preferencias de datos) y nos muestra la pantalla de ¡Todo listo!. Pulsamos en Terminar.

Con esto accedemos al panel principal (Resumen), que Home Assistant organiza por áreas del hogar.

Desde Configuración gestionamos todo lo demás: en Dispositivos y servicios añadimos las integraciones (Home Assistant suele detectar automáticamente muchos dispositivos de la red) y en Automatizaciones y escenas creamos nuestras reglas.

Mantenimiento

Para actualizar Home Assistant a la última versión descargamos la nueva imagen y recreamos el contenedor (la configuración se conserva en ./config):

root@homeassistant:/opt/homeassistant# docker compose pull
root@homeassistant:/opt/homeassistant# docker compose up -d

Y con esto ya hemos terminado la instalación de Home Assistant en Debian 13, listo para empezar a añadir integraciones y crear nuestras primeras automatizaciones del hogar.