Home Assistant — Panel de visualización del hogar¶

Panel de visualización de dispositivos del hogar. Consumo eléctrico, sensores, enchufes, temperatura. Solo lectura: las automatizaciones las gestiona Node-RED.

Como usuario¶

Qué podrás hacer¶

Ver el estado de todos los dispositivos del hogar
Consultar consumo eléctrico en tiempo real
Ver temperatura y humedad de cada estancia
Comprobar si las ventanas o puertas están abiertas
Ver el estado de los enchufes inteligentes

Cómo se accederá¶

Plataforma	Cómo
Navegador	`https://ha.sc`
Ubuntu	Navegador
Android	App Home Assistant desde Google Play
FireTV	No aplica

⚠️ Home Assistant es solo para visualización. NO gestiona automatizaciones — eso lo hace Node-RED.

Integración con otros servicios de SmallCountry¶

Servicio	Relación
Node-RED	Recibe todos los datos de sensores y actuadores — Home Assistant solo los muestra
Mosquitto	Los datos MQTT (protocolo de mensajería ligera para IoT) de los sensores pasan por Mosquitto → Node-RED → Home Assistant
Grafana	Métricas más detalladas y dashboards avanzados
n8n	Puede enviar notificaciones basadas en estados de HA

Servicios que lo hacen posible¶

Docker — contenedor homeassistant/home-assistant:latest

Para el administrador (diseño previsto)

Datos del servicio¶


LXC (contenedor ligero de Proxmox)	122
IP	10.10.20.122
Tier	B
Impacto	🟢 Bajo — solo visualización

Almacenamiento persistente¶


ZFS (sistema de archivos con integridad de datos) dataset	`rpool/datos/homeassistant`
Montaje en LXC	`/opt/homeassistant/`
Subdirectorios	`config/` `data/` `logs/`
Backup	PBS (sistema de copias de seguridad de Proxmox) diario

Healthcheck¶

curl -s https://ha.sc

Logs y diagnóstico¶

docker logs --tail 100 homeassistant

Backup manual¶

zfs snapshot rpool/datos/homeassistant@manual-$(date +%Y%m%d)

Problemas comunes¶

"Dispositivo no aparece": verificar que Node-RED está publicando en MQTT
"Valores incorrectos": reiniciar el flujo en Node-RED que publica ese sensor

Para el arquitecto (diseño previsto)

Relaciones con otros servicios¶

flowchart LR
    Caddy[Caddy LXC 102] -->|TLS + forward_auth| HomeAssistant[Home Assistant LXC 122]
    Authentik[Authentik LXC 105] -->|autenticación proxy| Caddy
    Mosquitto[Mosquitto MQTT] -->|datos de sensores| NodeRED[Node-RED]
    NodeRED -->|publica estados| HomeAssistant
    HomeAssistant -->|visualización solo lectura| Usuarios[Usuarios del hogar]

Configuración de red¶

Bridge	Puerto	Acceso desde
vmbr2	8123	Caddy (LXC 102)

En Pi-hole¶

ha.sc  →  10.10.20.122

En Caddy¶

ha.sc {
    forward_auth authentik.sc
    reverse_proxy 10.10.20.122:8123
}

En Authentik¶


Provider	Proxy
Grupos asignados	familia

Orquestación¶

Componente	Path
Rol Ansible	`roles/homeassistant/`
Playbook	`deploy-homeassistant.yml`
Módulo OpenTofu	`modules/homeassistant/`
Semaphore	Proyecto `homeassistant`, Template `deploy`
Forgejo Actions	`.forgejo/workflows/homeassistant.yml`
Repo Forgejo	`infra-core/`
Ficha versionada	`docs/fichas/programas/homeassistant.md`

Secciones relacionadas¶

🌐 Enlaces de interés¶

Sitio oficial · Documentación · GitHub