Solução da comunidade

Instalar o Home Assistant no CasaOS com o BigBearCasaOS: configuração atual do contentor, configuração persistente e limitações dos 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.

A publicação original do fórum de 2024 é principalmente uma referência para um tutorial da BigBear, pelo que não deve ser tratada como uma receita de instalação completa e imutável. A boa notícia atual é que a BigBearCasaOS continua a manter um pacote do Home Assistant que utiliza a imagem oficial do contentor do Home Assistant. A decisão arquitetural importante não é apenas «pode ser executado?», mas sim que tipo de instalação do Home Assistant pretende.

O Home Assistant Container funciona bem no CasaOS/Docker e oferece a interface e as integrações normais do Home Assistant Core. No entanto, a documentação atual do projeto é explícita: o Container não inclui o Home Assistant Supervisor nem o ecossistema de aplicações/complementos disponível no Home Assistant OS. Se precisar da experiência completa do HAOS/Supervisor, execute o Home Assistant OS em hardware compatível ou numa máquina virtual.

A BigBearCasaOS Continua a Manter o Home Assistant

O catálogo atual da BigBearCasaOS lista ghcr.io/home-assistant/home-assistant e continua a sincronizar pacotes de aplicações nas plataformas suportadas.

Consulte o catálogo atual da BigBearCasaOS.

Torne Persistente o Diretório /config

A configuração, a base de dados e as definições das integrações do Home Assistant encontram-se em /config no modelo de contentor. Mapeie essa pasta para armazenamento persistente do CasaOS e faça uma cópia de segurança antes de atualizações importantes.

A recriação do contentor não deverá apagar a instância do Home Assistant enquanto /config permanecer intacto.

O Home Assistant Utiliza Normalmente a Rede do Anfitrião

As orientações atuais para o Home Assistant Container utilizam --network=host, o que facilita os protocolos de deteção local e evita a publicação manual de todas as portas dos serviços.

A rede do anfitrião também significa que o contentor partilha o espaço de nomes de rede do anfitrião, por isso analise cuidadosamente os conflitos de portas e a exposição da firewall.

O Bluetooth Requer Acesso Adicional ao Anfitrião

As instruções atuais do projeto indicam que uma montagem D-Bus é opcional, mas necessária para a integração Bluetooth na configuração Docker documentada. Os adaptadores USB Zigbee/Z-Wave também podem exigir o mapeamento explícito de dispositivos.

Não presuma que um adaptador USB aparecerá no Home Assistant apenas porque o CasaOS consegue ver o dispositivo USB.

O Container Não Inclui Aplicações/Complementos do Supervisor

Esta é a maior diferença em relação ao Home Assistant OS. A documentação atual do Home Assistant indica que a instalação Container não tem acesso a aplicações/complementos e que o HAOS é o tipo de instalação recomendado para a maioria dos utilizadores que pretendem o ecossistema gerido completo.

Consulte a documentação atual do Home Assistant Container.

Utilize o Home Assistant OS numa Máquina Virtual para Obter a Experiência Gerida Completa

Se o anfitrião CasaOS tiver CPU/RAM suficientes e suporte para virtualização, o HAOS numa máquina virtual dá ao Home Assistant o seu próprio sistema operativo, Supervisor e complementos, enquanto o CasaOS continua a ser o anfitrião dos restantes serviços.

Planeie separadamente a passagem dos adaptadores USB se a máquina virtual precisar de hardware Zigbee/Z-Wave.

Mantenha o Acesso Remoto ao Home Assistant Intencional

O Home Assistant controla câmaras, fechaduras, sensores e o estado da automação. Não publique diretamente a porta 8123 na Internet sem um plano deliberado de acesso remoto e autenticação. Prefira a opção oficial de cloud do Home Assistant, uma VPN/rede sobreposta ou um proxy inverso protegido com autenticação.

Faça uma Cópia de Segurança do Home Assistant Antes das Atualizações

Nas instalações Container, proteja o diretório persistente /config e qualquer base de dados externa utilizada pela instância. Teste um restauro antes de depender do NAS como única cópia do estado da sua automação doméstica.

Perguntas Frequentes sobre o Home Assistant no CasaOS

A BigBearCasaOS continua a disponibilizar o Home Assistant?

Sim. O catálogo atual da BigBear continua a listar a imagem oficial do contentor do Home Assistant.

O Home Assistant Container inclui complementos do Supervisor?

Não. A documentação atual do Home Assistant afirma explicitamente que as instalações Container não têm aplicações/complementos.

E se eu quiser a experiência completa do HAOS?

Utilize o Home Assistant OS em hardware compatível ou numa máquina virtual, configurando a passagem para a máquina virtual de quaisquer adaptadores USB necessários.