Home Automation System · v2.0

DOMOTEC

Sistema de domótica distribuido sobre Raspberry Pi 5 y VirtualBox, interconectado mediante ZeroTier con control centralizado en Home Assistant.

2 Casas
HA Plataforma
ZT Red VPN
24/7 Monitoreo
Ver Arquitectura Documentación
SCROLL
// 01 · Arquitectura del sistema

Dos casas. Un ecosistema.

Arquitectura distribuida con dos instancias de Home Assistant sincronizadas via ZeroTier SDN.

🏠 CASA 1 · PRINCIPAL
Raspberry Pi 5
Home Assistant OS · Nativo
Hardware RPi 5 · 8GB RAM
SO HAOS · ARM64
Almacenamiento SSD NVMe 256GB
Estado ● ONLINE
IP Local 192.168.1.50
IP ZeroTier 10.147.x.x
ZeroTier
SDN
⟺
VPN
P2P
🏡 CASA 2 · SECUNDARIA
VirtualBox VM
Home Assistant OS · Virtualizado
Hypervisor VirtualBox 7.x
SO Huésped HAOS · x86_64
RAM asignada 4GB
Estado ● ONLINE
IP Local 192.168.x.x
IP ZeroTier 10.147.x.x
// Capas del sistema
🧠
Capa de Control
Home Assistant como núcleo de automatización. Gestión de entidades, automatizaciones, scripts y dashboards.
🔗
Capa de Red
ZeroTier crea una red virtual P2P entre ambas instancias. Sin necesidad de VPN tradicional ni apertura de puertos.
📡
Capa de Dispositivos
Integración con protocolos Zigbee, Z-Wave, Wi-Fi y Matter. Cada entidad expuesta en el bus de HA.
🔐
Capa de Seguridad
Acceso remoto cifrado via ZeroTier. Autenticación MFA en HA. Backups automáticos programados.
📊
Capa de Datos
InfluxDB + Grafana para telemetría histórica. Recorder de HA para estados. Alertas configurables.
🤖
Capa de Automatización
Blueprints personalizados. Node-RED integrado. Condiciones temporales, de presencia y de estado.
// 02 · Dispositivos & Entidades

Ecosistema conectado

Dispositivos integrados en el sistema, organizados por protocolo y función.

💡
ACTIVO
Bombillas Zigbee
Iluminación inteligente
Zigbee 3.0 HA Light Dimable
🌡️
ACTIVO
Sensor Temp/Humedad
Sensor ambiental Zigbee
Zigbee 3.0 HA Sensor MQTT
🚪
ACTIVO
Sensor Puerta/Ventana
Detector apertura Zigbee
Zigbee 3.0 Binary Sensor
🔌
ACTIVO
Enchufe Z-Wave
Toma inteligente con medición
Z-Wave Plus HA Switch Energía
🔒
ACTIVO
Cerradura Z-Wave
Cerradura inteligente
Z-Wave Plus HA Lock Cifrado
📹
ACTIVO
Cámara IP
Vigilancia RTSP/ONVIF
Wi-Fi RTSP HA Camera
🌡️
ACTIVO
Termostato Wi-Fi
Control HVAC integrado
Wi-Fi HA Climate Energía
📻
ACTIVO
Coordinador Zigbee
ConBee II / Sonoff Zigbee 3.0
USB Dongle ZHA / Z2M
🔗
ACTIVO
ZeroTier Client
Red SDN distribuida
Add-on HA VPN P2P Cifrado
📦
ACTIVO
MQTT Broker
Mosquitto · Add-on HA
Add-on HA MQTT 5.0
📊
ACTIVO
Grafana + InfluxDB
Telemetría y dashboards
Docker HA Integration
🔊
ACTIVO
Altavoz Inteligente
Google Home / Alexa integrado
Wi-Fi HA Media TTS
// 03 · Topología de red

Interconexión ZeroTier

Red virtual SDN que conecta ambas instancias de Home Assistant sin exposición pública de puertos.

// MAPA DE RED · DOMOTEC
🏠 CASA 1 · Raspberry Pi 5
Home Assistant OS 192.168.1.50
Coordinador Zigbee USB · /dev/ttyUSB0
MQTT Broker :1883
ZeroTier Client 10.147.x.x
Dispositivos Zigbee Red mesh 2.4GHz
SDN · E2E Encrypted
Network ID
ab34c567xx
🏡 CASA 2 · VirtualBox
Home Assistant OS 192.168.x.x
VirtualBox Host NAT / Bridged
ZeroTier Client 10.147.x.x
Dispositivos Wi-Fi Red local
Sensores Z-Wave USB Passthrough
ℹ  La comunicación entre instancias se realiza sobre la red ZeroTier (10.147.0.0/16). Cada HA conoce la dirección del otro y puede consultar sus entidades mediante la integración nativa "Home Assistant" o via API REST. El tráfico viaja cifrado extremo a extremo sin necesidad de abrir puertos en el router.
// 04 · Documentación & Pasos

Guía de instalación

Proceso completo de configuración del sistema DOMOTEC desde cero.

01

Preparar Raspberry Pi 5

HARDWARE

Configuración inicial del hardware base: Raspberry Pi 5 con almacenamiento SSD NVMe y sistema operativo Home Assistant.

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

# Verificar almacenamiento
lsblk
df -h
CONFIG · config.txt 
# /boot/config.txt
dtparam=audio=off
dtparam=pciex1_gen=3   # PCIe Gen 3 para NVMe
arm_boost=1
usb_max_current_enable=1
02

Instalar Home Assistant OS

SOFTWARE

Flasheo de la imagen oficial de Home Assistant OS en el SSD NVMe de la Raspberry Pi 5.

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

# Descomprimir y flashear (reemplazar sdX por tu dispositivo)
xz -d haos_rpi5-64-xx.x.img.xz
sudo dd if=haos_rpi5-64-xx.x.img of=/dev/sdX bs=4M status=progress
sync
INFO · Primera configuración 
# Acceder al onboarding
http://homeassistant.local:8123

# O por IP directa
http://192.168.1.50:8123

# Credenciales iniciales
Usuario: admin
Contraseña: [configurar en onboarding]
03

Configurar VirtualBox

VIRTUALIZACIÓN

Instalación de Home Assistant OS en una máquina virtual VirtualBox para la segunda casa.

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

# Crear VM con VBoxManage
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.
04

Configurar ZeroTier

RED

Creación de la red SDN privada que interconecta ambas instancias de Home Assistant.

BASH · Instalar ZeroTier en HAOS 
# En Home Assistant: Ajustes → Add-ons → Tienda
# Buscar e instalar: ZeroTier One

# Configuración del add-on (options)
network_id: "tu-network-id-aqui"

# Verificar unión a red
# En ZeroTier Central: https://my.zerotier.com
# Autorizar el dispositivo en la red
YAML · Configuración add-on 
# ZeroTier One Add-on config
network_id: "ab34c567xxxxxxxx"
api_auth_token: ""  # Opcional: para gestión via API

# IPs asignadas (ejemplo)
# Casa 1 (RPi5):      10.147.17.10
# Casa 2 (VBox):      10.147.17.20
05

Integración HA ↔ HA

INTEGRACIÓN

Configurar cada instancia de Home Assistant para conocer y compartir entidades con la otra.

YAML · configuration.yaml 
# En Casa 1: añadir Casa 2 como instancia remota
# Ajustes → Dispositivos → Integraciones → "Home Assistant"
# URL de Casa 2 via ZeroTier:
http://10.147.17.20:8123

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

# En configuration.yaml de Casa 1 (entidades remotas)
homeassistant_remote:
  - host: 10.147.17.20
    token: "eyJ0eXAiOiJKV1..."
    verify_ssl: false
06

Zigbee y Z-Wave

PROTOCOLOS

Configuración de los coordinadores Zigbee y Z-Wave para integrar dispositivos físicos en el ecosistema.

YAML · ZHA config (Zigbee) 
# Zigbee Home Automation (ZHA)
# Ajustes → Integraciones → Añadir integración → ZHA
device: /dev/ttyUSB0  # ConBee II / Sonoff
baudrate: 115200

# Alternativa: Zigbee2MQTT
# Instalar add-on Zigbee2MQTT + Mosquitto
serial:
  port: /dev/ttyUSB0
mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://localhost:1883
07

MQTT y Add-ons

ADD-ONS

Instalación y configuración de add-ons esenciales: Mosquitto MQTT, Node-RED, y herramientas de monitoreo.

YAML · Mosquitto config 
# Add-on: 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
08

Automatizaciones

LÓGICA

Ejemplos de automatizaciones básicas que aprovechan la arquitectura distribuida de DOMOTEC.

YAML · Automatización ejemplo 
# Notificación cross-casa: si se abre puerta Casa 1,
# encender luz de 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"
✓
Con ZeroTier activo, las entidades de Casa 2 aparecen en el registro de Casa 1 con prefijo remoto y pueden usarse en automatizaciones como cualquier entidad local.
✓ Documentación completa