Docker: Home Assistant - para qué sirve y cómo instalarlo

octubre 22, 2026

Publicado por Curso Docker

Imagen Docker del curso, nº 6. Home Assistant es la plataforma de domótica de código abierto más popular: integra luces, enchufes, sensores, cámaras y miles de dispositivos y permite crear automatizaciones, todo en local.

¿Para qué sirve?

Automatizar la casa sin depender de la nube de cada fabricante.

Instalación con docker run

Este es el comando del README oficial (cambia las rutas /path/to/... por carpetas de tu equipo):

docker run -d \
  --name=homeassistant \
  --net=host \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 8123:8123 `#optional` \
  -v /path/to/homeassistant/data:/config \
  --device /path/to/device:/path/to/device `#optional` \
  --restart unless-stopped \
  lscr.io/linuxserver/homeassistant:latest

Instalación con Docker Compose

Ejemplo de docker-compose.yml del README oficial. Guárdalo como docker-compose.yml y ejecuta docker compose up -d:

services:
  homeassistant:
    image: lscr.io/linuxserver/homeassistant:latest
    container_name: homeassistant
    network_mode: host
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/homeassistant/data:/config
    ports:
      - 8123:8123 #optional
    devices:
      - /path/to/device:/path/to/device #optional
    restart: unless-stopped

Consejos

Sustituye siempre las rutas de ejemplo por carpetas reales de tu equipo.
Comprueba que el contenedor está activo con docker ps y revisa los logs con docker logs NOMBRE.
Cambia las contraseñas por defecto antes de exponer el servicio fuera de tu red.

Antes de empezar con Home Assistant

Necesitas un equipo con Docker instalado y funcionando. Comprueba la versión con docker --version y la de Compose con docker compose version. Si tu usuario no está en el grupo docker, tendrás que anteponer sudo a los comandos. Mira también que el puerto 8123 estén libres con ss -tulpn | grep 8123: si otro servicio usa alguno, el contenedor no arrancará y tendrás que elegir otro puerto en la parte izquierda de la asignación.

Cómo comprobar que Home Assistant funciona

Después de arrancar el contenedor, ejecuta docker ps y busca homeassistant en la lista con estado Up. Si aparece reiniciándose o desaparece al poco rato, lee el motivo con docker logs -f homeassistant; casi siempre es una ruta mal escrita o un permiso. Cuando esté estable, si la aplicación tiene interfaz web, ábrela en el navegador con la dirección y el puerto que indica el README oficial. Dale un minuto en el primer arranque, porque algunas aplicaciones preparan su base de datos antes de aceptar conexiones.

Dónde se guardan los datos

En el ejemplo se montan estas rutas: /path/to/homeassistant/data:/config, /path/to/device:/path/to/device. La parte de la izquierda es la carpeta de tu equipo y la de la derecha es la ruta dentro del contenedor. Todo lo que quieras conservar debe estar en una carpeta montada, porque lo que queda dentro del contenedor se pierde si lo eliminas. Crea las carpetas antes de arrancar, con el usuario que vaya a usarlas, para evitar errores de permisos.

Cómo actualizar Home Assistant

Para actualizar con Compose, ve a la carpeta del docker-compose.yml y ejecuta docker compose pull seguido de docker compose up -d. Docker descarga la imagen nueva y recrea el contenedor sin tocar tus carpetas montadas. Después puedes limpiar imágenes viejas con docker image prune.

Copia de seguridad de Home Assistant

Antes de actualizar o cambiar nada, copia las carpetas que montaste. Lo más seguro es parar el contenedor con docker stop homeassistant, comprimir la carpeta con tar czf copia-homeassistant.tar.gz /ruta/a/tu/carpeta y volver a arrancarlo con docker start homeassistant. Guarda la copia en otro disco o en otro equipo, y prueba a restaurarla de vez en cuando: una copia que nunca has probado no es una garantía.

Fuentes: README en GitHub · Docker Hub

Buscar este blog

Curso Docker