Instalação · Nucleum Hub

Antes de começar

Home Assistant 2026.3 ou mais recente, em qualquer tipo de instalação: Home Assistant OS, Container, Core ou Supervised.
Uma conta de administrador, para a instalação e a primeira inicialização.
HACS, se você quiser o caminho de um clique. Sem ele, use o zip.
Internet para o Home Assistant quando você adiciona a integração: ela inicia a sua avaliação de 60 minutos com o nosso servidor.
Navegadores: Chrome / Edge 105+, Safari 16+, Firefox 121+. Não tem certeza sobre o seu tablet? Abra antes a demonstração nele.

1. Adicione o nosso repositório ao HACS

O Nucleum Hub não está na lista padrão do HACS: você adiciona o nosso repositório ao HACS como repositório personalizado, uma vez.

Com um clique: abra Adicionar ao HACS com o My Home Assistant. Ele abre o seu Home Assistant e pede ao HACS que adicione o nosso repositório; confirme com Adicionar.
Manualmente: no HACS, abra o menu ⋮ › Repositórios personalizados, cole https://github.com/iulianmara/nucleum-hub, escolha o tipo Integração e toque em Adicionar.

2. Baixe e reinicie

No HACS, abra o Nucleum Hub e toque em Baixar.
Reinicie o Home Assistant: Configurações › Sistema › Reiniciar.

3. Adicione a integração

Configurações › Dispositivos e serviços › Adicionar integração › Nucleum Hub e, depois, Enviar. O Nucleum Hub aparece na barra lateral, em cada tela conectada ao seu Home Assistant, e a sua avaliação de 60 minutos começa: todas as funções, em tempo corrido, uma vez por instalação do Home Assistant.

4. Cole a sua chave de licença

Comprou uma licença? A sua chave vem de nós por e-mail, logo após o pagamento.

Abra Configurações › Dispositivos e serviços › Nucleum Hub › Configurar.
Cole a chave e confirme. Maiúsculas, minúsculas e espaços não importam.
A integração a ativa on-line uma vez e depois a verifica sozinha com o nosso servidor. Guarde o e-mail: nós guardamos só uma impressão digital da chave.

Casas sem internet, mudanças e a instalação de teste: Licença e ativação.

Sem HACS: o zip

Baixe o zip da versão mais recente do nosso repositório no GitHub.
Descompacte-o na pasta de configuração do seu Home Assistant, a que contém configuration.yaml. No fim, você deve ter custom_components/wall_dashboard/.
Reinicie o Home Assistant e siga os passos 3 e 4 acima.

No Home Assistant OS, abra essa pasta pelo computador com o complemento Samba share ou com o Studio Code Server. No Container e no Core, é a pasta que você montou ou definiu como config. A pasta wall_dashboard tem o nome técnico da integração; no Home Assistant ela aparece como Nucleum Hub.

Abra o Nucleum Hub na barra lateral

Abra o Nucleum Hub pela barra lateral, com uma conta de administrador. O assistente de configuração tem três etapas: o seu idioma e um nome para a saudação, as páginas que você quer e o que ele encontrou na sua casa (solar, rede, bateria, tempo, alarme e mais), que você pode corrigir. Toque em Criar painel.

A sua configuração fica salva no Home Assistant, não no navegador: é por isso que todas as telas mostram o mesmo, e é por isso que os backups do seu Home Assistant a incluem.

Depois de uma atualização, as telas já abertas mostram o botão Nova versão: toque nele para carregar a nova versão. Elas nunca recarregam sozinhas.

Em um tablet de parede

O endereço: abra http://homeassistant.local:8123/nucleum-hub, com o endereço do seu Home Assistant no lugar de homeassistant.local:8123, e entre uma vez, com “Manter conectado”.
Fully Kiosk Browser: use o mesmo endereço como URL inicial.
Sem a barra lateral do Home Assistant: no tablet, abra o seu perfil (o seu nome, embaixo na barra lateral) e ative a opção que sempre oculta a barra lateral (em inglês “Always hide the sidebar”). Ela vale só para esse navegador; para desativá-la, abra http://homeassistant.local:8123/profile no tablet.

Celulares com o app do Home Assistant, e um painel próprio para cada tela: O app Companion e o Fully Kiosk.

Se o seu Home Assistant filtra o tráfego de saída

A integração só fala com api.nucleumhub.com (licença e avaliação); as atualizações vêm do GitHub, pelo HACS. As suas telas não falam com nenhum dos dois.

Instalação manual, como alternativa de emergência

Só se a integração não puder funcionar, ou se o nosso suporte pedir. O painel é um único arquivo do pacote: custom_components/wall_dashboard/frontend/wall-dashboard.html.

Copie-o, com a pasta wall-dashboard-weather que fica ao lado, para a pasta www da sua pasta de configuração. Se não havia pasta www, crie-a e reinicie o Home Assistant.
Configurações › Painéis › Adicionar painel › Página da web, com o endereço /local/wall-dashboard.html.

Ele lê a sua configuração do Home Assistant, então as suas telas ficam iguais. As versões novas vêm só com a integração.