Solução da comunidade

Executar o Home Assistant OS no ZimaOS ZVM: QCOW2, UEFI e definições da VM

An April–May 2026 ZVM thread where Home Assistant OS appeared stuck when created from a VDI with BIOS firmware. Multiple community users reported better results with QCOW2 plus UEFI, matching Home Assistant's current KVM guidance.

Executar o Home Assistant Container a partir da App Store do ZimaOS não é o mesmo que executar o Home Assistant OS. O contentor fornece o Home Assistant Core dentro do Docker, enquanto o HAOS é uma imagem appliance completa, com suplementos geridos pelo Supervisor e o seu próprio ambiente operativo. O autor original queria a experiência completa do HAOS porque algumas integrações Tuya e Xiaomi não estavam a funcionar bem na implementação em contentor.

A primeira tentativa no ZVM nunca passou do ecrã de carregamento, mesmo depois de ficar ligada durante toda a noite. A discussão não demonstrou que o próprio ZVM fosse incapaz de executar o HAOS. Em vez disso, respostas posteriores identificaram duas opções de configuração que deveriam ser alteradas primeiro: o utilizador tinha selecionado uma imagem de disco .vdi do VirtualBox e firmware BIOS legado.

Como Era a Configuração Original da VM

Configuração do ZimaOS ZVM com uma imagem VDI do Home Assistant, disco de 64 GB, 4 GB de RAM, rede em bridge e firmware BIOS
A VM de origem utilizava um disco VDI e firmware BIOS. As respostas posteriores concentraram-se primeiro nestas duas definições, antes de sugerirem alterações mais invasivas.
Consola de máquina virtual do ZimaOS para o Home Assistant OS bloqueada num indicador de carregamento
A VM não passou desta fase na configuração original.

Prefira a Imagem QCOW2 para um Hipervisor ao Estilo KVM

Um membro da comunidade que executava o Home Assistant OS no ZVM há cerca de dois meses afirmou que utilizava a imagem QCOW2. Essa recomendação é coerente com a página atual de transferências de máquinas virtuais do Home Assistant, que disponibiliza QCOW2 para hipervisores ao estilo KVM/Proxmox.

Para uma nova implementação no ZVM, comece com a imagem atual do Home Assistant OS destinada a máquinas virtuais ao estilo KVM. Uma imagem VDI está principalmente associada ao VirtualBox e não é a escolha inicial mais natural para o ZVM.

Utilize Firmware UEFI

A VM de origem utilizava BIOS. Duas respostas independentes da comunidade sugeriram mudar para UEFI, e as orientações atuais do Home Assistant exigem UEFI para máquinas virtuais HAOS.

Definições bem-sucedidas da comunidade para o ZimaOS ZVM com o Home Assistant OS, utilizando QCOW2, 2 GB de RAM, rede em bridge e firmware UEFI
Um utilizador que tinha executado o HAOS no ZVM partilhou esta configuração com QCOW2 e UEFI como referência funcional.

Não Dimensione Excessivamente a VM Antes de Resolver a Compatibilidade de Arranque

A VM original tinha um disco virtual de 64 GB e 4 GB de RAM. Outro utilizador relatou utilizar um disco de 32 GB, com cerca de metade do espaço ainda livre, e um resumo da comunidade sugeriu começar com cerca de 2 vCPUs, 2–4 GB de RAM e 32 GB de capacidade de disco.

Mais CPU, RAM ou armazenamento não resolverão um problema de firmware ou de formato de imagem. Resolva primeiro o caminho de arranque e, em seguida, aumente os recursos com base nos suplementos, no período de retenção do histórico, nas bases de dados e nas integrações efetivamente utilizadas.

Dê Tempo ao Primeiro Arranque para Inicializar

Uma resposta indicou que o HAOS pode permanecer numa consola preta ou silenciosa durante vários minutos enquanto expande o armazenamento e inicializa os serviços. Isso é diferente de deixar o mesmo estado de carregamento durante toda a noite. Depois de mudar para uma imagem compatível e UEFI, permita tempo suficiente para o primeiro arranque antes de concluir que está bloqueado.

Não Foi Demonstrado que o VDI Fosse Impossível

A correção mais forte à conclusão simplista de que “o VDI não funciona” surgiu mais tarde na discussão: outro utilizador de um ZimaBoard 2 afirmou que o Home Assistant OS 17.3 em formato VDI funcionava para si quando a VM utilizava UEFI. Isto significa que o formato da imagem, por si só, não foi demonstrado como a causa principal.

A conclusão mais rigorosa é que QCOW2 com UEFI é a configuração inicial mais segura, pois corresponde à família de hipervisores pretendida e a um relato comunitário de sucesso no ZVM. A UEFI parece ser o requisito mais importante.

Quando o Contentor do Home Assistant no ZimaOS é Suficiente

Página da App Store do ZimaOS para a aplicação de contentor do Home Assistant
A versão da App Store é mais fácil de implementar, mas não fornece o modelo completo do Supervisor e dos suplementos do HAOS.

Se as integrações necessárias funcionarem no Home Assistant Container, esta opção é mais leve e evita executar um segundo sistema operativo dentro de uma VM. Se precisar especificamente dos suplementos do HAOS ou do modelo de gestão ao estilo appliance, o ZVM pode ser adequado, mas também acrescenta outra camada de virtualização que tem de ser mantida em boas condições durante as atualizações do ZimaOS.

Um Hipervisor Separado é Outra Arquitetura

Um participante sugeriu instalar o Proxmox na máquina física N150 e executar o ZimaOS e o Home Assistant OS como máquinas virtuais separadas. Isso pode isolar o Home Assistant da manutenção do ZimaOS, mas altera toda a arquitetura do anfitrião e não deve ser apresentado como necessário para resolver esta discussão.

Ordem Prática de Resolução de Problemas

  1. Transfira a imagem atual do HAOS para máquinas virtuais, em vez de reutilizar um ficheiro antigo.
  2. Comece com QCOW2, se o ZVM o aceitar.
  3. Selecione firmware UEFI.
  4. Atribua recursos moderados, como 2 vCPUs, 2–4 GB de RAM e cerca de 32 GB de disco.
  5. Utilize um modo de rede que forneça à VM HAOS um endereço LAN utilizável.
  6. Permita tempo suficiente para a inicialização do primeiro arranque.
  7. Se a VM continuar sem arrancar, inspecione a consola antes de alterar as definições de armazenamento ou da aplicação.

Perguntas Frequentes sobre o Home Assistant OS no ZVM

Que imagem devo experimentar primeiro?

QCOW2 é a melhor escolha inicial, pois destina-se a hipervisores ao estilo KVM e funcionou numa implementação comunitária do ZVM.

O ZVM deve utilizar BIOS ou UEFI para o HAOS?

Utilize UEFI. Os requisitos atuais do Home Assistant indicam explicitamente a utilização de UEFI.

O HAOS precisa de um disco virtual de 64 GB?

Não para uma instalação básica. Utilizadores da comunidade relataram que 32 GB funcionam confortavelmente, embora um histórico extenso ou muitos suplementos possam justificar mais espaço.

Foi demonstrado que o VDI não é suportado?

Não. Um utilizador de um ZimaBoard 2 relatou posteriormente uma implementação VDI funcional com UEFI.