Solución de la comunidad

Instalar Home Assistant en CasaOS con BigBearCasaOS: configuración actual del contenedor, configuración persistente y límites de los complementos

A January 2024 community post pointing to a BigBearCasaOS Home Assistant tutorial. The forum post itself does not preserve the installation parameters or a user validation. BigBearCasaOS still maintains a Home Assistant package today using the official ghcr.io/home-assistant/home-assistant image, while current Home Assistant documentation clarifies that the Container installation type does not include Supervisor apps/add-ons.

La publicación original del foro de 2024 es principalmente un enlace a un tutorial de BigBear, por lo que no debe tratarse como una receta de instalación completa e inmutable. La buena noticia actual es que BigBearCasaOS todavía mantiene un paquete de Home Assistant que utiliza la imagen oficial del contenedor de Home Assistant. La decisión arquitectónica importante no es solo «¿puede ejecutarse?», sino qué tipo de instalación de Home Assistant quieres.

Home Assistant Container funciona bien en CasaOS/Docker y ofrece la interfaz de usuario y las integraciones habituales de Home Assistant Core. Sin embargo, la documentación actual del proyecto es explícita: Container no incluye Home Assistant Supervisor ni el ecosistema de aplicaciones/complementos disponible en Home Assistant OS. Si necesitas la experiencia completa de HAOS/Supervisor, ejecuta Home Assistant OS en hardware compatible o en una máquina virtual.

BigBearCasaOS todavía mantiene Home Assistant

El catálogo actual de BigBearCasaOS incluye ghcr.io/home-assistant/home-assistant y continúa sincronizando paquetes de aplicaciones entre sus plataformas compatibles.

Usa el catálogo actual de BigBearCasaOS.

Conserva el directorio /config

La configuración, la base de datos y los ajustes de las integraciones de Home Assistant se encuentran en /config dentro del modelo de contenedor. Asigna esa carpeta a un almacenamiento persistente de CasaOS y haz una copia de seguridad antes de realizar actualizaciones importantes.

Recrear el contenedor no debería borrar la instancia de Home Assistant mientras /config permanezca intacto.

Home Assistant suele utilizar la red del host

Las instrucciones actuales para Home Assistant Container utilizan --network=host, lo que facilita los protocolos de descubrimiento local y evita tener que publicar manualmente cada puerto del servicio.

La red del host también significa que el contenedor comparte el espacio de nombres de red del host, así que revisa cuidadosamente los conflictos de puertos y la exposición del cortafuegos.

Bluetooth necesita acceso adicional al host

Las instrucciones actuales del proyecto indican que el montaje de D-Bus es opcional, pero necesario para la integración de Bluetooth en la configuración de Docker documentada. Las radios Zigbee/Z-Wave USB también pueden requerir una asignación explícita de dispositivos.

No des por hecho que una radio USB aparecerá en Home Assistant simplemente porque CasaOS puede ver el dispositivo USB.

Container no incluye aplicaciones ni complementos de Supervisor

Esta es la mayor diferencia con Home Assistant OS. La documentación actual de Home Assistant indica que la instalación Container no tiene acceso a aplicaciones ni complementos, y que HAOS es el tipo de instalación recomendado para la mayoría de los usuarios que desean el ecosistema administrado completo.

Consulta la documentación actual de Home Assistant Container.

Usa Home Assistant OS en una máquina virtual para disfrutar de la experiencia administrada completa

Si el host de CasaOS tiene suficiente CPU/RAM y compatibilidad con la virtualización, HAOS en una máquina virtual proporciona a Home Assistant su propio sistema operativo, Supervisor y complementos, mientras CasaOS sigue siendo el host de los demás servicios.

Planifica por separado el paso directo de las radios USB si la máquina virtual necesita hardware Zigbee/Z-Wave.

Mantén intencional el acceso remoto a Home Assistant

Home Assistant controla cámaras, cerraduras, sensores y estados de automatización. No publiques directamente el puerto 8123 en Internet sin un diseño deliberado de acceso remoto y autenticación. Prefiere la opción oficial de nube de Home Assistant, una VPN/red superpuesta o un proxy inverso reforzado y autenticado.

Haz una copia de seguridad de Home Assistant antes de actualizar

En las instalaciones Container, protege el directorio persistente /config y cualquier base de datos externa utilizada por la instancia. Prueba una restauración antes de depender del NAS como única copia del estado de tu sistema domótico.

Preguntas frecuentes sobre Home Assistant en CasaOS

¿BigBearCasaOS todavía empaqueta Home Assistant?

Sí. El catálogo actual de BigBear todavía incluye la imagen oficial del contenedor de Home Assistant.

¿Home Assistant Container incluye los complementos de Supervisor?

No. La documentación actual de Home Assistant indica explícitamente que las instalaciones Container no tienen aplicaciones ni complementos.

¿Qué ocurre si quiero disfrutar de la experiencia completa de HAOS?

Usa Home Assistant OS en hardware compatible o en una máquina virtual, configurando el paso directo de cualquier radio USB necesaria.