Se pretende a experiência “completa” do Home Assistant, com Supervisor, aplicações/complementos, cópias de segurança e atualizações geridas pelo Home Assistant, a escolha fundamental é o tipo de instalação do Home Assistant, não uma versão específica do ZimaOS. Essa foi a resposta central no tópico da IceWhale Community de janeiro de 2026.
O Home Assistant Container pode ser executado normalmente como uma aplicação Docker no ZimaOS, mas a documentação atual do Home Assistant afirma explicitamente que a instalação Container não tem acesso às aplicações do Home Assistant. Se quiser manter o ZimaOS e, ainda assim, obter a experiência completa do HAOS, a solução de compromisso mais sólida, apoiada pelas fontes, é executar o Home Assistant Operating System como uma máquina virtual. Um utilizador da comunidade confirmou tê-lo feito dentro da ZVM e relatou ter acesso ao HACS e aos complementos.
As três opções práticas para o Home Assistant
| Método | Mantém o ZimaOS? | Supervisor / Aplicações | Ideal para |
|---|---|---|---|
| Home Assistant Container no ZimaOS | Sim | Não | Utilizadores satisfeitos por gerirem eles próprios os contentores de suporte |
| Home Assistant OS numa ZVM | Sim | Sim | Experiência completa do HA, mantendo o ZimaOS |
| Home Assistant OS em bare metal | Não, se for instalado no mesmo disco | Sim | Máquina dedicada ao Home Assistant |
Opção 1: Home Assistant Container no ZimaOS
Se instalar o Home Assistant através do Docker no ZimaOS, estará a executar o Home Assistant Container. Este fornece o Home Assistant Core num contentor e é um tipo de instalação do Home Assistant oficialmente suportado.
A documentação atual do Home Assistant é explícita:
- O Home Assistant Container é executado no Docker ou noutro runtime compatível com OCI.
- Não inclui o Home Assistant Supervisor.
- Não disponibiliza aplicações/complementos do Home Assistant.
- A gestão dos serviços de suporte e das atualizações fica a seu cargo.
Referência atual: guia de instalação do Home Assistant para x86-64 genérico.
“Sem complementos” não significa que não possa executar MQTT, ESPHome ou outros serviços
Muitos complementos do Home Assistant são interfaces para software que também existe como contentores Docker normais. Com o Home Assistant Container no ZimaOS, pode frequentemente executar serviços como brokers MQTT, ESPHome, Node-RED ou bases de dados como contentores separados.
A diferença está na gestão: o Home Assistant Supervisor não irá instalar, atualizar, monitorizar, fazer cópias de segurança nem integrar esses contentores como complementos do Home Assistant. A gestão do ciclo de vida do Docker passa a ser da sua responsabilidade.
Opção 2: Executar o Home Assistant OS como VM no ZVM
Uma resposta posterior no tópico original forneceu a resposta mais útil específica para o ZimaOS. O membro da comunidade ZimaRat afirmou que transferiu uma imagem de máquina virtual do Home Assistant, copiou-a para o ZimaOS, abriu o ZVM, selecionou Instalação personalizada, escolheu a imagem nos Ficheiros do ZimaOS e iniciou o Home Assistant OS como VM.
Referiram que, depois de o HAOS ser inicializado, conseguiram instalar o HACS e os add-ons. Outro membro experiente da comunidade concordou que esta era uma forma válida de manter o ZimaOS e, ao mesmo tempo, obter a experiência completa do HAOS.
Porque é que o método da VM proporciona a experiência completa do Home Assistant
O Home Assistant OS é um sistema operativo appliance completo. Quando é executado dentro de uma máquina virtual de hardware, continua a controlar o seu próprio disco virtual e o ambiente Home Assistant Supervisor.
Isso é fundamentalmente diferente de iniciar apenas a aplicação Home Assistant como um contentor Docker dentro do ZimaOS.
A documentação atual do Home Assistant suporta oficialmente o HAOS como máquina virtual em hipervisores compatíveis e fornece imagens como:
- VirtualBox
.vdi; - KVM/Proxmox
.qcow2; - VMware
.ova.
Referência oficial: Guia de instalação do Home Assistant OS numa máquina virtual.
O utilizador da fonte utilizou uma imagem VirtualBox no ZVM
A resposta da comunidade especificou que utilizaram a imagem VirtualBox da página de instalação alternativa do Home Assistant, extraíram-na, copiaram-na para o ZimaOS e selecionaram-na no ZVM.
Esse é um resultado confirmado pela comunidade para a versão 2026 do ZVM. Não deve ser generalizado como uma afirmação de que todas as futuras versões do ZVM suportarão inalteradamente todos os formatos de imagem do Home Assistant. Ao criar uma VM nova, utilize um formato de imagem aceite pela interface atual do ZVM.
Requisitos de recursos da VM
O guia atual de VMs do Home Assistant indica um mínimo de:
2 GB de RAM
2 vCPUsAtribua mais recursos se planeia utilizar add-ons mais exigentes, processamento de voz, bases de dados, câmaras ou cargas de automação significativas.
Mantenha CPU e memória suficientes disponíveis para o ZimaOS e para as restantes aplicações, em vez de atribuir todos os recursos do anfitrião à VM do HAOS.
Os rádios Zigbee, Z-Wave e USB precisam de passagem direta
A resposta original identificou corretamente uma das contrapartidas do HAOS no ZVM: é necessário passar para a VM dispositivos USB físicos, como coordenadores Zigbee ou Z-Wave.
Se o rádio não estiver visível dentro do HAOS, o Home Assistant não poderá utilizá-lo, mesmo que o ZimaOS detete o dispositivo USB no anfitrião.
Antes de avançar com o desenho baseado em VM, confirme se a versão atual do ZVM suporta o redirecionamento USB necessário para o seu hardware de automação.
Opção 3: Substituir o ZimaOS pelo Home Assistant OS
Se o mini PC for dedicado inteiramente ao Home Assistant, instalar o HAOS diretamente no hardware proporciona o ambiente completo do Home Assistant mais simples.
No entanto, o tópico original simplificou inicialmente a instalação como “gravar o HAOS numa pen USB e instalá-lo”. Um utilizador posterior salientou corretamente que o HAOS não fornece um instalador tradicional que arranque a partir de USB e se grave a si próprio no disco interno.
A documentação atual do Home Assistant afirma:
O HAOS não tem um instalador integrado que grave automaticamente a imagem.
Para hardware x86-64 genérico, o método recomendado é arrancar a partir de uma pen USB live do Ubuntu e utilizar o utilitário Discos para restaurar a imagem de disco do HAOS no disco interno de destino. Outro método consiste em gravar diretamente a imagem de disco do HAOS no suporte de arranque de destino a partir de outro computador.
Instalar o HAOS no disco do ZimaOS apaga o ZimaOS
O Home Assistant OS é, por si só, um sistema operativo. Se gravar a imagem do HAOS na unidade física que contém atualmente o Windows ou o ZimaOS, o sistema operativo antigo e os dados dessa unidade de destino serão substituídos.
Faça primeiro uma cópia de segurança dos dados. Uma “instalação da aplicação Home Assistant” e uma “instalação do Home Assistant OS” são operações completamente diferentes.
É possível manter ambos em discos físicos separados?
As respostas da comunidade também mencionaram utilizar um disco para o ZimaOS e outro para o Home Assistant OS, selecionando depois o dispositivo de arranque no firmware. Isso evita substituir o outro sistema operativo, mas não é o mesmo que ter ambos os ambientes ativos simultaneamente.
Se quiser ter o ZimaOS e o Home Assistant completo a funcionar simultaneamente na mesma máquina, a abordagem HAOS-em-ZVM é mais prática.
O HAOS bare-metal pode apresentar diferenças de compatibilidade de hardware/firmware
Um participante posterior relatou ter gravado o HAOS num NVMe externo para uma ZimaBoard, mas recebeu um erro de arranque relacionado com o deslocamento do kernel nesse hardware, embora o mesmo NVMe tenha arrancado noutro sistema.
O tópico não estabeleceu uma solução universal confirmada. Esse resultado é mais uma razão para não descrever o HAOS bare-metal como garantido em todos os dispositivos Zima x86. UEFI, Secure Boot, controlador de armazenamento e comportamento do firmware são importantes.
Requisitos atuais do HAOS genérico para x86-64
O guia atual do Home Assistant exige:
- um sistema Intel/AMD de 64 bits;
- modo de arranque UEFI;
- Secure Boot desativado;
- um disco de arranque ou suporte de arranque dedicado;
- acesso à rede/internet para a configuração inicial.
Depois de o HAOS iniciar, o Home Assistant está normalmente disponível em:
http://homeassistant.local:8123ou através do endereço IP da máquina virtual/dispositivo na porta 8123.
Que método deve escolher?
Escolha o Home Assistant Container no ZimaOS se:
- já gere Docker com à-vontade;
- não precisa de add-ons geridos pelo Supervisor;
- quer executar o Home Assistant juntamente com muitas aplicações comuns do ZimaOS, com um impacto mínimo da máquina virtual.
Escolha o Home Assistant OS na ZVM se:
- quer o Supervisor e o ecossistema de aplicações/add-ons do Home Assistant;
- quer manter o ZimaOS em execução na mesma máquina;
- se sente à vontade a atribuir recursos à máquina virtual e a passar diretamente dispositivos USB.
Escolha o Home Assistant OS diretamente no hardware se:
- a máquina será dedicada ao Home Assistant;
- não precisa do ZimaOS nessa máquina;
- quer o modelo de dispositivo Home Assistant mais simples e oficialmente recomendado.
Lista de verificação para o Home Assistant completo no ZimaOS
- Decida se realmente precisa do Supervisor/add-ons.
- Caso contrário, o Home Assistant Container no ZimaOS poderá ser suficiente.
- Se sim e quiser manter o ZimaOS, crie uma máquina virtual HAOS na ZVM.
- Utilize uma imagem atual do Home Assistant OS para máquinas virtuais, compatível com o seu fluxo de trabalho de virtualização.
- Atribua pelo menos 2 GB de RAM e 2 vCPUs, e mais para cargas de trabalho exigentes.
- Passe diretamente dispositivos Zigbee/Z-Wave/USB se o Home Assistant precisar deles.
- Utilize a funcionalidade de cópia de segurança do próprio HAOS dentro da máquina virtual.
- Se instalar o HAOS diretamente no hardware, tenha em conta que a gravação da imagem substitui o sistema operativo no disco de destino.
Perguntas frequentes sobre o Home Assistant completo no ZimaOS
Que versão do ZimaOS permite utilizar add-ons do Home Assistant?
Nenhuma versão específica do ZimaOS o faz. A disponibilidade de add-ons depende da execução do Home Assistant OS/Supervisor e não do Home Assistant Container.
A aplicação Docker do Home Assistant no ZimaOS consegue instalar add-ons?
Não. A documentação atual do Home Assistant indica que a instalação em Contentor não tem acesso às aplicações/add-ons do Home Assistant.
A ZVM consegue executar o Home Assistant completo?
O tópico original inclui uma configuração do HAOS numa ZVM confirmada por um utilizador, com HACS e add-ons. Considere-a um fluxo de trabalho do ZimaOS confirmado pela comunidade e verifique o suporte atual para a imagem ZVM e para a passagem direta de USB.
A instalação do Home Assistant OS apaga o ZimaOS?
Sim, se instalar o HAOS no mesmo disco físico que contém atualmente o ZimaOS. Executar o HAOS numa máquina virtual evita essa substituição.
