Home Assistant: Automatiza tu Casa desde Cero en 2025

Introducción: Tu casa inteligente sin depender de la nube

Home Assistant es la plataforma de domótica open source más completa del mercado. Conecta miles de dispositivos de cientos de fabricantes, todo controlado desde tu servidor local sin depender de nubes de terceros.

En esta guía te enseño a montar tu sistema de domótica completo desde cero: instalación, integración de dispositivos, creación de automatizaciones avanzadas, integración con n8n para workflows complejos, y dashboards personalizados.

¿Por qué Home Assistant?

Comparativa con otras plataformas

Casos de uso ideales

• Privacidad crítica: No quieres que Google/Amazon/Apple sepan cuándo estás en casa
• Multi-ecosistema: Dispositivos Philips Hue + Xiaomi + Tuya + Sonoff mezclados
• Automatizaciones complejas: «Si sensor movimiento detecta Y temperatura < 18°C Y hora entre 22:00-07:00 ENTONCES encender calefacción modo eco"
• Integración con servicios propios: n8n, Nextcloud, Grafana, Jellyfin
• DIY avanzado: Sensores ESP32/ESP8266 personalizados con ESPHome
• Presence detection avanzada: WiFi, Bluetooth, GPS, sensores PIR

Métodos de instalación

Comparativa métodos de instalación

Recomendación:

• Raspberry Pi 4/5 dedicada: Home Assistant OS (método más fácil y completo)
• Servidor con múltiples servicios: Docker Container (comparte recursos)
• VM en Proxmox: Home Assistant OS en VM (mejor opción para homelabs)

Instalación método 1: Home Assistant OS en Raspberry Pi

Hardware necesario

• Raspberry Pi 4/5: Mínimo 4GB RAM (8GB recomendado)
• MicroSD 32GB+ (Clase 10, A2 recomendado) o SSD USB (mejor performance)
• Fuente alimentación oficial: 5V 3A (USB-C para Pi 4/5)
• Adaptador Zigbee (opcional): Sonoff Zigbee 3.0 USB (~15€), ConBee II (~40€), SkyConnect (~35€)
• Ethernet cable (WiFi funciona pero Ethernet más estable)

Coste total: 90-180€ (según modelo Pi y periféricos)

Paso 1: Flashear imagen Home Assistant OS

1. Descargar Raspberry Pi Imager: raspberrypi.com/software
2. Insertar microSD en PC
3. Abrir Raspberry Pi Imager
4. CHOOSE DEVICE → Raspberry Pi 4 (o tu modelo)
5. CHOOSE OS → Other specific-purpose OS → Home assistants and home automation → Home Assistant → Home Assistant OS XX.X (latest)
6. CHOOSE STORAGE → Seleccionar tu microSD
7. ⚙️ (Settings opcional):
   • Hostname: homeassistant.local
   • Enable SSH (opcional, para troubleshooting)
   • Configure WiFi (si no usas Ethernet)
8. WRITE → Esperar 5-10 min

Paso 2: Primer arranque

1. Insertar microSD en Raspberry Pi
2. Conectar Ethernet (recomendado) o WiFi
3. Conectar alimentación → LED rojo fijo + LED verde parpadeando
4. Esperar 10-20 minutos (primer arranque instala todo, toma tiempo)

Cómo saber cuándo está listo:

• LED verde deja de parpadear frenéticamente
• Acceder a http://homeassistant.local:8123 (o http://IP_DE_LA_PI:8123)
• Si aparece «Preparing Home Assistant», esperar más (puede tomar hasta 30 min en primera vez)

Paso 3: Configuración inicial (Onboarding)

Welcome screen:

1. Create your account:
   • Name: Tu nombre
   • Username: admin (o el que prefieras)
   • Password: Contraseña fuerte (guardar en gestor)
2. Location:
   • Detecta ubicación automáticamente (o ajustar manualmente)
   • Timezone: Verificar que sea correcto
   • Elevation: Metros sobre nivel del mar (para cálculos sol/luna precisos)
3. Share anonymous data: Opcional (ayuda al proyecto pero no obligatorio)
4. Detected devices:
   • Home Assistant detecta automáticamente dispositivos en tu red
   • Seleccionar los que quieras añadir (puedes saltarlo y añadir después)
5. Click Finish

¡Bienvenido a Home Assistant! 🏠🎉

Instalación método 2: Docker Container

Para servidores que ya corren otros servicios (ideal si tienes Proxmox, Docker host, etc.).

Docker Compose (recomendado)

Archivo: docker-compose.yml

version: '3.8'

services:
  homeassistant:
    container_name: homeassistant
    image: ghcr.io/home-assistant/home-assistant:stable
    volumes:
      - ./config:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro  # Para Bluetooth
    restart: unless-stopped
    privileged: true  # Necesario para USB devices (Zigbee, Z-Wave)
    network_mode: host  # Requerido para discovery automático
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0  # Adaptador Zigbee/Z-Wave (ajustar según tu device)
    environment:
      - TZ=Europe/Madrid

Desplegar:

# Crear directorio config
mkdir -p config

# Levantar container
docker compose up -d

# Ver logs (primer arranque tarda 5-10 min)
docker compose logs -f

# Acceder cuando veas "Home Assistant is running"
# http://IP_DEL_SERVIDOR:8123

Conceptos clave de Home Assistant

Arquitectura y terminología

Estructura de una automatización

alias: "Luz automática salón al detectar movimiento nocturno"
trigger:
  - platform: state
    entity_id: binary_sensor.movimiento_salon
    to: "on"
condition:
  - condition: time
    after: "22:00:00"
    before: "07:00:00"
  - condition: numeric_state
    entity_id: sensor.luminosidad_salon
    below: 50
action:
  - service: light.turn_on
    target:
      entity_id: light.salon
    data:
      brightness_pct: 30
      transition: 2

Explicación:

• Trigger: Sensor de movimiento cambia a «on»
• Conditions:
  • Hora entre 22:00 y 07:00
  • Luminosidad < 50 lux
• Action: Encender luz del salón al 30% brightness con transición suave de 2 segundos

Conectar dispositivos: Protocolos y métodos

1. Dispositivos WiFi (Tuya, Shelly, Sonoff, Xiaomi)

Ventajas: Sin hardware adicional, alcance ilimitado (cobertura WiFi)
Desventajas: Saturan WiFi, algunos requieren nube

Método A: Integración nativa (si dispositivo es compatible)

1. Settings → Devices & Services → Add Integration
2. Buscar marca (ej: Shelly, TP-Link Kasa, Xiaomi Mi Home)
3. Seguir wizard (usuario/password de cuenta o IP directa)
4. Devices aparecen automáticamente

Método B: Flashear firmware alternativo (Tasmota, ESPHome)

Para dispositivos Tuya/Sonoff genéricos que dependen de nube:

1. Flashear Tasmota o ESPHome (requiere abrir dispositivo y soldar pins en algunos casos)
2. Configurar WiFi y MQTT en Tasmota
3. En HA: Añadir integración MQTT
4. Auto-discovery detecta dispositivo Tasmota

Guía rápida Tasmota:

• Tutorial: tasmota.github.io/docs
• Compatible con 1000+ dispositivos ESP8266/ESP32
• Control local sin nube

2. Zigbee (protocolo mesh de bajo consumo)

Ventajas: Bajo consumo (baterías duran años), mesh auto-healing, 100+ devices en una red
Desventajas: Requiere coordinador USB (~15-40€)

Coordinadores recomendados:

• Sonoff Zigbee 3.0 USB Dongle Plus: ~15€, excelente relación calidad/precio
• ConBee II: ~40€, muy estable, soportado por Zigbee2MQTT y ZHA
• SkyConnect (oficial HA): ~35€, Thread + Zigbee, futuro-proof

Opción A: Zigbee2MQTT (recomendado, más flexible)

Requisitos: MQTT broker (Mosquitto)

Instalación con Home Assistant OS (Add-on):

1. Settings → Add-ons → Add-on Store
2. Buscar «Mosquitto broker» → Install → Start → Enable watchdog
3. Buscar «Zigbee2MQTT» → Install
4. Configuration:

   serial:
     port: /dev/ttyUSB0  # O el que corresponda a tu adaptador
     adapter: auto
   mqtt:
     server: mqtt://localhost:1883
     user: homeassistant
     password: tu_password_mqtt
   advanced:
     network_key: GENERATE  # Se genera automáticamente
     pan_id: GENERATE
   homeassistant: true  # Auto-discovery
   

5. Start → Enable watchdog
6. Open Web UI → Verás interfaz de Zigbee2MQTT

Emparejar dispositivo Zigbee:

1. En Web UI de Zigbee2MQTT: Click Permit join (All)
2. En dispositivo físico: Presionar botón reset 5 segundos (varía según dispositivo)
3. LED del dispositivo parpadea → emparejando
4. Aparece en Zigbee2MQTT con modelo detectado
5. Automáticamente aparece en Home Assistant (auto-discovery)

Dispositivos Zigbee populares:

• Sensores movimiento: Aqara, Sonoff SNZB-03 (~10€)
• Sensores puerta/ventana: Aqara, Sonoff SNZB-04 (~8€)
• Sensores temperatura/humedad: Aqara, Sonoff SNZB-02 (~10€)
• Bombillas: IKEA Tradfri (~8-15€), Philips Hue (~15-50€)
• Enchufes: IKEA Tradfri (~10€), Aqara Smart Plug (~15€)
• Botones: Aqara Mini Switch (~12€), IKEA Tradfri Shortcut (~8€)

Opción B: ZHA (Zigbee Home Automation, integración nativa HA)

Más simple pero menos flexible que Zigbee2MQTT.

1. Settings → Devices & Services → Add Integration → ZHA
2. Seleccionar serial port del coordinador
3. Next → Detecta automáticamente adaptador
4. Finish
5. Para emparejar: ZHA → Add device → Presionar botón en dispositivo físico

3. Bluetooth (BLE, corto alcance)

Ventajas: Sin hardware adicional (si tu servidor tiene BT), bajo consumo
Desventajas: Alcance corto (5-10m), menos dispositivos que Zigbee

Dispositivos BLE populares:

• Sensores Xiaomi Mi Temp (termómetro/higrómetro, ~10€)
• Switchbot (botones, cortinas, cerraduras)
• Tile trackers (presence detection)

Configuración:

1. Settings → Devices & Services → Add Integration → Bluetooth
2. Auto-detecta adaptador Bluetooth del sistema
3. Dispositivos BLE aparecen automáticamente en discovery

4. Z-Wave (protocolo mesh profesional)

Ventajas: Muy estable, seguro (AES-128), interoperabilidad garantizada
Desventajas: Dispositivos caros, requiere stick USB (~40-60€)

Stick recomendado: Aeotec Z-Stick 7 (~60€)

Configuración (similar a ZHA para Zigbee):

1. Settings → Devices & Services → Add Integration → Z-Wave
2. Seleccionar serial port del stick
3. Add device → Presionar botón en dispositivo Z-Wave

Crear automatizaciones avanzadas

Ejemplo 1: Sistema de seguridad básico

Objetivo: Si detecta movimiento cuando nadie está en casa → Enviar notificación al móvil + Encender todas las luces + Grabar cámara.

Vía UI (Visual Editor):

1. Settings → Automations & Scenes → Create Automation
2. Trigger:
   • Type: State
   • Entity: binary_sensor.movimiento_salon
   • To: on
3. Conditions:
   • Type: State
   • Entity: person.tu_nombre (detecta si estás en casa por GPS móvil)
   • State: not_home
4. Actions:
   • Action 1: Send notification
     • Service: notify.mobile_app_tu_telefono
     • Title: «⚠️ Movimiento detectado en casa»
     • Message: «Sensor salón activado a las {{ now().strftime(‘%H:%M’) }}»
   • Action 2: Turn on lights
     • Service: light.turn_on
     • Target: all (o seleccionar área «Casa completa»)
   • Action 3: Start camera recording
     • Service: camera.record
     • Target: camera.entrada
     • Duration: 60 (segundos)
5. Save → Nombre: «Alarma movimiento fuera de casa»

Ejemplo 2: Buenos días automático

Objetivo: Al despertarse (desactivar alarma móvil o detectar movimiento), si es día laborable → Abrir persianas, encender cafetera, leer noticias por altavoz, encender luces baño.

Vía YAML (más potente):

alias: "Buenos días laborables"
trigger:
  - platform: state
    entity_id: binary_sensor.movimiento_dormitorio
    to: "on"
condition:
  - condition: time
    after: "06:00:00"
    before: "09:00:00"
  - condition: state
    entity_id: binary_sensor.workday  # Sensor de día laborable
    state: "on"
  - condition: state
    entity_id: cover.persiana_dormitorio
    state: "closed"  # Solo si persiana está cerrada
action:
  - service: cover.open_cover
    target:
      entity_id:
        - cover.persiana_dormitorio
        - cover.persiana_salon
  - delay: "00:00:30"  # Esperar 30s para que abran persianas
  - service: switch.turn_on
    target:
      entity_id: switch.cafetera
  - service: light.turn_on
    target:
      entity_id: light.bano
    data:
      brightness_pct: 50
      color_temp: 350  # Luz cálida
  - service: tts.google_translate_say
    target:
      entity_id: media_player.altavoz_cocina
    data:
      message: >
        Buenos días. Son las {{ now().strftime('%H:%M') }}.
        La temperatura exterior es {{ states('sensor.temperatura_exterior') }} grados.
        Hoy {{ states('sensor.weather_forecast') }}.
mode: single  # Solo ejecutar una vez aunque se detecte movimiento múltiple

Ejemplo 3: Presencia simulada (vacaciones)

Objetivo: Cuando estás de vacaciones, encender/apagar luces aleatoriamente para simular presencia.

alias: "Simulación presencia - Modo vacaciones"
trigger:
  - platform: time_pattern
    hours: "/1"  # Cada hora
condition:
  - condition: state
    entity_id: input_boolean.modo_vacaciones  # Switch manual para activar
    state: "on"
  - condition: sun
    after: sunset
    before: sunrise
action:
  - service: light.turn_on
    target:
      entity_id: >
        {{ ['light.salon', 'light.cocina', 'light.dormitorio'] | random }}
    data:
      brightness_pct: "{{ range(30, 80) | random }}"
  - delay:
      minutes: "{{ range(15, 45) | random }}"
  - service: light.turn_off
    target:
      entity_id: all
mode: restart  # Si se ejecuta mientras corre, reinicia

Integración con n8n (workflows avanzados)

Home Assistant + n8n = Automatizaciones imposibles con HA solo.

Casos de uso n8n + HA

• Notificaciones complejas: Telegram con botones interactivos («¿Apagar calefacción? SÍ/NO»)
• Lógica compleja: Consultar API externa (clima, tráfico, bolsa) y actuar según resultado
• Logging avanzado: Guardar estados en PostgreSQL, crear gráficos con Grafana
• Integración servicios: Google Calendar → Si evento «Reunión» → Activar modo «No molestar» (luces, timbre)
• AI/LLM: Enviar snapshot de cámara a OpenAI Vision → «¿Hay alguien en la puerta?» → Responder por Telegram

Configurar webhooks HA → n8n

Paso 1: Crear webhook en n8n

1. n8n → New workflow
2. Añadir nodo Webhook
3. HTTP Method: POST
4. Path: home-assistant/evento
5. Copiar URL del webhook (ej: https://n8n.tudominio.com/webhook/home-assistant/evento)

Paso 2: Llamar webhook desde automatización HA

alias: "Enviar evento a n8n cuando se abre puerta"
trigger:
  - platform: state
    entity_id: binary_sensor.puerta_entrada
    to: "on"
action:
  - service: rest_command.n8n_webhook
    data:
      evento: "puerta_abierta"
      timestamp: "{{ now().isoformat() }}"
      persona: "{{ states('sensor.ultima_persona_detectada') }}"

Paso 3: Configurar rest_command en HA

Editar configuration.yaml:

rest_command:
  n8n_webhook:
    url: "https://n8n.tudominio.com/webhook/home-assistant/evento"
    method: POST
    content_type: "application/json"
    payload: >
      {
        "evento": "{{ evento }}",
        "timestamp": "{{ timestamp }}",
        "persona": "{{ persona }}"
      }

Reiniciar Home Assistant → Ahora cada vez que se abre puerta, n8n recibe webhook y puede hacer cualquier cosa (enviar Telegram, guardar en DB, etc.).

Controlar HA desde n8n

Nodo Home Assistant en n8n:

1. Instalar nodo: n8n → Settings → Community Nodes → n8n-nodes-homeassistant
2. Crear credential:
   • Host: http://192.168.1.100:8123
   • Access Token: Generar en HA (Profile → Long-Lived Access Tokens → Create Token)
3. Usar nodo:
   • Operation: Call Service
   • Domain: light
   • Service: turn_on
   • Entity ID: light.salon
   • Data: {"brightness": 255}

Ahora n8n puede controlar cualquier dispositivo de HA. 🎉

Dashboards personalizados (Lovelace)

La interfaz por defecto de HA es funcional pero genérica. Lovelace permite crear dashboards a medida.

Crear dashboard personalizado

1. Overview (dashboard por defecto) → ⋮ (menú) → Edit Dashboard
2. Click + Add Card
3. Tipos de cards populares:
   • Entities: Lista de entidades (luces, switches)
   • Thermostat: Control climatización
   • Gauge: Medidor circular (temperatura, humedad)
   • History Graph: Gráfico histórico de sensores
   • Picture Entity: Imagen con control superpuesto
   • Media Control: Controlar Spotify, Plex, Chromecast
   • Markdown: Texto/HTML personalizado
   • Conditional: Card que solo aparece si se cumple condición
4. Configurar card (visual o YAML)
5. Save

Ejemplo: Dashboard salón

Layout:

• Fila 1: Clima (temperatura, humedad, forecast)
• Fila 2: Luces del salón (dimmer + color)
• Fila 3: Media player (Chromecast/Spotify)
• Fila 4: Cámara entrada (live view)

YAML ejemplo:

type: vertical-stack
cards:
  - type: horizontal-stack
    cards:
      - type: gauge
        entity: sensor.temperatura_salon
        name: Temperatura
        min: 10
        max: 35
        severity:
          green: 20
          yellow: 25
          red: 30
      - type: gauge
        entity: sensor.humedad_salon
        name: Humedad
        min: 0
        max: 100
        unit: "%"
  - type: light
    entity: light.salon
    name: Luz salón
  - type: media-control
    entity: media_player.chromecast_salon
  - type: picture-glance
    title: Entrada
    camera_image: camera.entrada
    entities:
      - binary_sensor.movimiento_entrada
      - binary_sensor.puerta_entrada

Custom cards (HACS)

HACS (Home Assistant Community Store) tiene 1000+ custom cards, integraciones y themes.

Instalar HACS:

1. Seguir guía oficial: hacs.xyz/docs/setup
2. Reiniciar HA
3. Settings → Devices & Services → Add Integration → HACS
4. Autorizar con GitHub

Custom cards populares:

• Mushroom Cards: Diseño minimalista moderno
• Mini Graph Card: Gráficos compactos potentes
• Button Card: Botones ultra-personalizables
• Auto Entities: Generar cards dinámicamente según filters
• Lovelace Card Templater: Cards con Jinja2 templates

ESPHome: Dispositivos DIY

ESPHome permite crear sensores/actuadores personalizados con ESP32/ESP8266 sin programar C++, solo YAML.

Ejemplo: Sensor temperatura DHT22 + ESP32

Hardware:

• ESP32 DevKit (~5€)
• Sensor DHT22 (~3€)
• Cables dupont

Instalación ESPHome (Add-on en HA OS):

1. Settings → Add-ons → ESPHome → Install
2. Start → Open Web UI
3. Click + New Device
4. Name: sensor-temperatura-salon
5. WiFi SSID y password
6. Select device type: ESP32
7. Click Install → Conectar ESP32 por USB → Flashear

Configuración YAML:

esphome:
  name: sensor-temperatura-salon
  platform: ESP32
  board: esp32dev

wifi:
  ssid: "TuWiFi"
  password: "TuPassword"
  ap:
    ssid: "Sensor-Temp-Fallback"

api:
  encryption:
    key: "AUTO_GENERATED_KEY"

ota:
  password: "ota_password"

sensor:
  - platform: dht
    pin: GPIO4
    model: DHT22
    temperature:
      name: "Temperatura Salón"
      id: temp_salon
    humidity:
      name: "Humedad Salón"
      id: hum_salon
    update_interval: 60s

Resultado: En 10 minutos tienes sensor temperatura/humedad que aparece automáticamente en HA, actualiza cada 60s, sin nube, control total.

Troubleshooting común

Problema 1: Dispositivo no aparece en discovery

Causas:

• mDNS bloqueado (firewall, router con AP isolation)
• Device en VLAN diferente
• Integration no configurada

Soluciones:

# Verificar mDNS en red
avahi-browse -a

# Añadir dispositivo manualmente (ej: Shelly)
# Settings → Devices & Services → Add Integration → Shelly
# Ingresar IP manualmente: 192.168.1.50

Problema 2: Zigbee2MQTT no detecta dispositivos

Diagnóstico:

1. Abrir Web UI de Zigbee2MQTT
2. Logs → Ver si hay errores
3. Verificar coordinador conectado (Settings → About)

Soluciones:

• Permit join deshabilitado: Activar «Permit join (All)»
• Dispositivo ya emparejado: Reset completo (presionar botón 10s hasta LED parpadea rápido)
• Coordinador saturado: Máximo 20-40 devices directos (usar routers Zigbee para extender)
• Interferencia: Cambiar canal Zigbee (Settings → Network → Channel → cambiar a 11, 15, 20 o 25)

Problema 3: Automatización no se ejecuta

Diagnóstico:

1. Settings → Automations → Seleccionar automatización
2. ⋮ → Traces → Ver últimas ejecuciones
3. Revisar si trigger activó, conditions cumplidas, actions ejecutadas

Causas comunes:

• Condition no cumplida: Tiempo, estado, valor numérico
• Entity ID incorrecto: Verificar nombre exacto
• Mode single + ya ejecutándose: Cambiar mode a restart o queued
• Syntax error en YAML: Validar en Developer Tools → YAML → Check Configuration

Problema 4: HA muy lento / no responde

Causas:

• Base de datos (recorder) muy grande
• Demasiados devices/sensores (polling constante)
• SD card corrupta (Raspberry Pi)
• RAM insuficiente

Soluciones:

# Limpiar base de datos antigua
# Settings → System → Storage → Recorder → Purge

# O limitar retención en configuration.yaml:
recorder:
  purge_keep_days: 7  # Solo mantener 7 días de historia
  exclude:
    domains:
      - sensor  # Excluir sensores de DB (solo states actuales)
    entity_globs:
      - sensor.uptime*
      - sensor.last_boot*

# Migrar de SD a SSD (Raspberry Pi)
# https://community.home-assistant.io/t/moving-ha-from-sd-card-to-ssd/

# Aumentar RAM de VM (Proxmox)
# Shutdown VM → Hardware → Memory → Aumentar a 4GB

Problema 5: Notificaciones móvil no llegan

Requisitos:

• App oficial Home Assistant instalada (iOS/Android)
• Logged in en app
• Permisos de notificaciones habilitados
• HA accesible desde internet (o Nabu Casa Cloud)

Test:

# Developer Tools → Services
service: notify.mobile_app_tu_telefono
data:
  message: "Test notificación"
  title: "Test"

# Si no llega:
# 1. Verificar nombre servicio correcto (Settings → Devices → Tu móvil → Entities)
# 2. Reinstalar app móvil
# 3. Verificar HA accesible por HTTPS (certificado válido)

Optimización y mejores prácticas

Performance

• ✅ SSD en lugar de SD card (Raspberry Pi: 10x más rápido, durabilidad infinitamente mayor)
• ✅ Limitar recorder a 7-14 días, excluir sensores no críticos
• ✅ Usar push en lugar de polling cuando sea posible (MQTT, webhooks vs HTTP polling)
• ✅ Reducir update_interval de sensores no críticos (temperatura: 60s suficiente, no 10s)
• ✅ MariaDB/PostgreSQL en lugar de SQLite (para sistemas grandes, 100+ entities)
• ✅ Routers Zigbee para extender mesh (enchufes siempre conectados hacen de router)

Seguridad

• ✅ HTTPS obligatorio para acceso remoto (Cloudflare Tunnel, Nginx + Let’s Encrypt, o Nabu Casa)
• ✅ MFA (2FA) habilitado (Settings → Profile → Multi-factor Authentication)
• ✅ Firewall activo (solo puerto 8123 abierto si expones, mejor VPN o Tunnel)
• ✅ Contraseñas fuertes en cuentas HA
• ✅ Actualizar regularmente (Settings → Updates)
• ✅ Backups automáticos (Settings → Backups → Schedule)
• ✅ Secrets en secrets.yaml no hardcodear passwords en configuration.yaml

Organización

• ✅ Areas bien definidas (cada room = area, asignar devices a areas)
• ✅ Naming convention consistente (light.cocina, sensor.temperatura_cocina)
• ✅ Packages para modularizar config (lights.yaml, climate.yaml, etc.)
• ✅ Comentarios en automatizaciones complejas (explica qué hace y por qué)
• ✅ Tags en automatizaciones (security, comfort, energy, etc.)

Recursos y comunidad

Documentación:

• home-assistant.io/docs/ – Documentación oficial completísima
• Integrations – 2,800+ integraciones oficiales
• esphome.io – ESPHome docs

Comunidad:

• community.home-assistant.io – Foro oficial (1M+ usuarios)
• r/homeassistant – Subreddit (500k+ miembros)
• Discord oficial – Chat en vivo

YouTube channels recomendados:

• Everything Smart Home
• Smart Home Junkie
• The Hook Up

Conclusión

Home Assistant es la plataforma definitiva para domótica seria sin depender de nubes de terceros. Con esta guía has aprendido:

• ✅ 4 métodos de instalación (HA OS, Container, Supervised, Core)
• ✅ Conectar dispositivos WiFi, Zigbee, Bluetooth, Z-Wave
• ✅ Crear automatizaciones avanzadas (triggers, conditions, actions)
• ✅ Integración con n8n para workflows imposibles con HA solo
• ✅ Dashboards personalizados con Lovelace + custom cards
• ✅ ESPHome para dispositivos DIY sin programar
• ✅ Troubleshooting de 5 problemas comunes
• ✅ Optimización y mejores prácticas

¡Bienvenido a la domótica sin límites! 🏠🤖

Preguntas Frecuentes sobre Home Assistant

¿Qué es Home Assistant y por qué usarlo?

Home Assistant es la plataforma open source más completa para domótica, con 2,800+ integraciones oficiales. Controla dispositivos de cientos de fabricantes (Philips Hue, Xiaomi, Shelly, Sonoff, Tuya) desde una sola interfaz, 100% local sin depender de nubes de terceros. A diferencia de Google Home o Alexa, funciona sin internet, tus datos son privados, y puedes crear automatizaciones complejas ilimitadas. Es gratis, funciona en Raspberry Pi o servidor, y tiene comunidad gigante (1M+ usuarios).

¿Qué hardware necesito para instalar Home Assistant?

Mínimo: Raspberry Pi 4 con 4GB RAM (100-120€ setup completo) es perfecto para empezar. También funciona en cualquier servidor con Docker, VM en Proxmox, o NUC/mini PC. Para dispositivos Zigbee necesitas coordinador USB (Sonoff Zigbee 15€, ConBee II 40€, SkyConnect oficial 35€). Para Z-Wave, stick Z-Wave (~60€). WiFi y Bluetooth funcionan sin hardware adicional. Con 4GB RAM y CPU moderna soportas fácilmente 50+ dispositivos inteligentes.

¿Qué diferencia hay entre Home Assistant y Google Home?

Home Assistant es local y open source: todo funciona sin internet, tus datos en TU casa, automatizaciones ilimitadas complejas, soporta 2,800+ integraciones vs ~300 de Google Home. Google Home requiere nube constante, tiene automatizaciones básicas limitadas, y Google conoce todos tus hábitos domésticos. Puedes usar ambos: Home Assistant como cerebro central y Google Home/Alexa solo como asistente de voz, delegando el control real a HA para privacidad.

¿Home Assistant funciona sin conexión a internet?

Sí, 100% operativo offline para dispositivos y automatizaciones locales (Zigbee, Z-Wave, WiFi local). Solo necesitas internet para: integraciones cloud (Google Calendar, weather API, Spotify), actualizaciones, y acceso remoto desde fuera de casa. Tus automatizaciones críticas (luces, seguridad, sensores) funcionan perfectamente aunque tu ISP caiga. Es una ventaja enorme vs sistemas cloud como Google Home o Alexa que se vuelven tontos sin internet.

¿Es mejor usar dispositivos Zigbee o WiFi para Home Assistant?

Zigbee para la mayoría: sensores con batería que duran años, bajo consumo, mesh auto-healing (se extiende solo), hasta 100+ devices en una red, dispositivos baratos (8-15€). WiFi para: dispositivos con alimentación constante (enchufes, luces), cuando ya tienes buenos WiFi devices (Shelly, Sonoff con Tasmota), o no quieres comprar coordinador. Evita WiFi para sensores a batería (duran días vs años Zigbee). Estrategia ideal: Zigbee como base, WiFi para casos específicos.

¿Cómo accedo a Home Assistant desde fuera de casa?

Tres opciones: 1) Cloudflare Tunnel (gratis, fácil, sin abrir puertos, SSL automático, recomendado), 2) Nabu Casa Cloud (6€/mes, oficial, soporta proyecto, setup cero), 3) VPN WireGuard (gratis, máxima privacidad y seguridad, acceso completo a red, requiere config). NUNCA expongas puerto 8123 directamente a internet sin VPN/tunnel. Con Cloudflare Tunnel tienes home.tudominio.com con HTTPS gratis en 30 minutos.

¿Puedo integrar Home Assistant con n8n?

Sí, perfectamente. Usa nodo oficial de Home Assistant en n8n (instala desde Community Nodes) o webhooks bidireccionales. Ejemplos: enviar eventos de sensores HA a Telegram vía n8n, crear workflows complejos (Google Calendar → activa escena en HA), analizar datos de sensores con IA y actuar según resultado, guardar histórico en PostgreSQL, integrar con servicios sin integración nativa HA. HA tiene automatizaciones potentes, pero n8n añade lógica de negocio compleja y conectores ilimitados.

¿Cuántos dispositivos inteligentes puede manejar Home Assistant?

Raspberry Pi 4 (4GB): hasta 50-100 devices sin problema. Servidor con 8GB+ RAM: 200-500+ devices fácilmente. El límite no es Home Assistant (escala muy bien), sino: 1) Red Zigbee (coordinador soporta ~40 devices directos, usar routers Zigbee para extender), 2) Rendimiento base de datos (migrar de SQLite a PostgreSQL si tienes 100+ sensores), 3) Updates frecuentes (muchos sensores con polling agresivo sobrecargan). Con hardware decente y configuración optimizada, 500+ dispositivos es totalmente viable.