01

Preparar Raspberry Pi 5

HARDWARE

Configuración inicial del hardware base: Raspberry Pi 5 con 4GB de RAM y almacenamiento SD Card de 32GB con sistema operativo Home Assistant. El RPi 4 ofrece rendimiento suficiente para un sistema domótico completo con múltiples integraciones.

ℹ
Se recomienda usar un SD Card 32GB via adaptador PCIe para mejor rendimiento. La tarjeta SD es válida pero el SSD prolonga la vida útil y acelera las operaciones de escritura del recorder de HA.
BASH · Verificar hardware 
# Verificar modelo y memoria
cat /proc/cpuinfo | grep Model
free -h

# Verificar almacenamiento detectado
lsblk
df -h
CONFIG · /boot/config.txt 
# Habilitar PCIe Gen 3 para NVMe y optimizar rendimiento
dtparam=audio=off
dtparam=pciex1_gen=3
arm_boost=1
usb_max_current_enable=1
← Volver a inicio Siguiente: HAOS →
02

Instalar Home Assistant OS

SOFTWARE

Flasheo de la imagen oficial de Home Assistant OS en el SD Card 32GB de la Raspberry Pi 5. HAOS es el sistema operativo dedicado que incluye todo lo necesario para ejecutar HA con acceso a add-ons y supervisor.

⚠
Descargar la imagen específica para Raspberry Pi 5 (rpi4-64). Las imágenes para RPi 4 no son compatibles con el hardware del RPi 5.
BASH · Flashear imagen HAOS 
# Descargar imagen HAOS para RPi5
wget https://github.com/home-assistant/operating-system/releases/latest/download/haos_rpi4-64-xx.x.img.xz

# Descomprimir y flashear al SSD (reemplazar sdX por tu dispositivo)
xz -d haos_rpi4-64-xx.x.img.xz
sudo dd if=haos_rpi4-64-xx.x.img of=/dev/sdX bs=4M status=progress
sync
INFO · Primer acceso 
# Acceder al onboarding desde el navegador
http://homeassistant.local:8123

# O por IP directa (ver IP en tu router)
http://192.168.1.210:8123

# Configurar usuario administrador en el primer acceso
Usuario: admin
Contraseña: [definir en onboarding]
← Anterior Siguiente: VirtualBox →
03

Configurar VirtualBox

VIRTUALIZACIÓN

Instalación de Home Assistant OS en una máquina virtual VirtualBox para simular la segunda casa. Esta VM funciona en cualquier ordenador con VirtualBox instalado.

BASH · Crear VM con VBoxManage 
# Descargar imagen HAOS para x86_64 genérico
wget https://github.com/home-assistant/operating-system/releases/latest/download/haos_ova-xx.x.vdi.zip

# Crear y configurar la VM
VBoxManage createvm --name "DOMOTEC-Casa2" --ostype Linux_64 --register
VBoxManage modifyvm "DOMOTEC-Casa2" --memory 4096 --vram 16
VBoxManage modifyvm "DOMOTEC-Casa2" --nic1 bridged --bridgeadapter1 eth0

# Adjuntar disco VDI
VBoxManage storagectl "DOMOTEC-Casa2" --name "SATA" --add sata
VBoxManage storageattach "DOMOTEC-Casa2" --storagectl "SATA" \
  --port 0 --device 0 --type hdd --medium haos_ova-xx.x.vdi
ℹ
Usar red en modo Bridged para que la VM obtenga IP en la misma red local. Esto facilita el descubrimiento y la conexión ZeroTier posterior.
← Anterior Siguiente: ZeroTier →
04

Configurar ZeroTier

RED

Creación de la red SDN privada que interconecta ambas instancias de Home Assistant sin necesidad de abrir puertos en el router ni configurar VPN tradicional.

YAML · Configuración add-on ZeroTier One 
# Instalar desde: Ajustes → Add-ons → Tienda → ZeroTier One
# Configuración del add-on:
network_id: "ebe7fbd44519d454"
api_auth_token: ""

# IPs asignadas tras autorizar en ZeroTier Central
# Casa 1 (RPi5):   172.29.254.219
# Casa 2 (VBox):   172.29.179.54
ℹ
Tras instalar el add-on en ambas instancias, ve a my.zerotier.com y autoriza los dos dispositivos en tu red. Cada uno recibirá una IP del rango 10.147.x.x.
← Anterior Siguiente: HA↔HA →
05

Integración HA ↔ HA

INTEGRACIÓN

Configurar cada instancia de Home Assistant para conocer y compartir entidades con la otra. Esto permite usar sensores de Casa 2 en automatizaciones de Casa 1 y viceversa.

YAML · configuration.yaml — Casa 1 
# Añadir Casa 2 como instancia remota en Casa 1
# Ajustes → Integraciones → "Home Assistant" → Añadir
# URL de Casa 2 via ZeroTier:
http://172.29.179.54:8123

# Generar token en Casa 2: Perfil → Tokens de larga duración → Crear

# En configuration.yaml de Casa 1:
homeassistant_remote:
  - host: 172.29.179.54
    token: "eyJ0eXAiOiJKV1..."
    verify_ssl: false
← Anterior Siguiente: Zigbee →
06

Zigbee y Z-Wave

PROTOCOLOS

Configuración de los coordinadores Zigbee y Z-Wave para integrar dispositivos físicos. Se puede usar ZHA (integrado en HA) o Zigbee2MQTT con Mosquitto.

YAML · ZHA — Zigbee Home Automation 
# Ajustes → Integraciones → Añadir → ZHA
device: /dev/ttyUSB0  # ConBee II / Sonoff Zigbee 3.0
baudrate: 115200
YAML · Zigbee2MQTT (alternativa) 
# Instalar add-on Zigbee2MQTT + Mosquitto broker
serial:
  port: /dev/ttyUSB0
mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://localhost:1883
  user: homeassistant
  password: tu-password
← Anterior Siguiente: MQTT →
07

MQTT y Add-ons

ADD-ONS

Instalación y configuración de los add-ons esenciales del sistema: Mosquitto como broker MQTT central, Node-RED para flujos visuales, y herramientas de administración.

YAML · Mosquitto broker 
logins:
  - username: homeassistant
    password: "tu-password-mqtt"
customize:
  active: false
certfile: fullchain.pem
keyfile: privkey.pem
✓
Add-ons recomendados:
Mosquitto broker · Node-RED · ZeroTier One · Zigbee2MQTT · File Editor · Terminal & SSH
← Anterior Siguiente: Automatizaciones →
08

Automatizaciones

LÓGICA

Ejemplos de automatizaciones YAML que aprovechan la arquitectura distribuida de DOMOTEC. Con ZeroTier activo, las entidades de ambas casas son accesibles como si fueran locales.

YAML · Automatización cross-casa 
# Si se abre la puerta de Casa 1 de noche → alerta en Casa 2
alias: "Alerta puerta Casa 1 → Casa 2"
trigger:
  - platform: state
    entity_id: binary_sensor.puerta_principal_c1
    to: "on"
condition:
  - condition: time
    after: "22:00:00"
    before: "07:00:00"
action:
  - service: light.turn_on
    target:
      entity_id: light.salon_alerta_c2
    data:
      color_name: red
      brightness_pct: 100
  - service: notify.mobile_app
    data:
      message: "⚠ Puerta abierta en Casa 1"
✓
Las entidades remotas de Casa 2 aparecen en Casa 1 con prefijo remoto y se usan exactamente igual que entidades locales en cualquier automatización.
← Anterior ✓ Documentación completa