Como instalar o Home Assistant no Saplo: integrações e primeira automação

Tens dispositivos de vários fabricantes e queres centralizar o seu controlo e automação num só lugar? O Home Assistant permite combinar serviços compatíveis num painel comum. Neste guia, vamos mostrar-te como instalar o Home Assistant na Saplo, fazer a primeira configuração e testar uma automação simples sem ligar hardware.

Quando é que o Home Assistant na Saplo faz sentido

A instalação na Saplo é ideal para integrações baseadas na Internet e como ambiente para aprender automação. O painel funciona num servidor no centro de dados e está disponível via HTTPS. No entanto, a compatibilidade de um determinado dispositivo depende da sua integração, método de comunicação e requisitos do fabricante.

A Box não tem acesso automático à tua rede doméstica. Introduzir um endereço de dispositivo privado, como 192.168.1.20, não irá estabelecer uma ligação a partir do servidor Saplo. Os dispositivos locais exigem conectividade configurada separadamente, por exemplo, um túnel VPN com as rotas e regras de acesso apropriadas. A instalação do Home Assistant por si só não cria esse túnel. A descoberta automática via mDNS ou SSDP também não começará a funcionar só porque conectas redes VPN.

A receita não fornece USB, pelo que não podes ligar diretamente um coordenador Zigbee ou Z-Wave doméstico. Se o teu sistema se baseia em sensores locais e controlo que funciona sem a Internet, considera manter o centro de automação em casa. Com uma instalação remota, a perda da Internet doméstica corta a comunicação com os dispositivos, mesmo que o próprio painel na Saplo continue a funcionar.

Requisitos e alojamento do Home Assistant na Saplo

O plano mais barato que cumpre os requisitos mínimos da receita é o Box M por 63 € anuais. A receita exige 2048 MB de RAM e 10 GB de espaço em disco. Se outras aplicações já estiverem a funcionar na Box, verifica os recursos disponíveis antes de instalar. O histórico de medições crescente e as integrações adicionais aumentam a necessidade de memória e espaço em disco.

Prepara uma Box ativa, o nome da aplicação e o endereço onde estará disponível. Não precisas de criar uma base de dados separada nem de instalar o Docker manualmente. Podes encontrar os detalhes do serviço na página do Home Assistant na Saplo.

A Saplo executa o Home Assistant na imagem de contentor oficial. Esta é uma instalação do tipo Home Assistant Container, sem o Supervisor e a loja de add-ons conhecidos do Home Assistant OS. As integrações adicionadas nas configurações do Home Assistant são uma funcionalidade diferente das aplicações geridas pelo Supervisor. As diferenças são descritas na documentação oficial de instalação do Container.

Instalação passo a passo

1. Inicia sessão no Painel Saplo e abre o catálogo de aplicações.
2. Procura por Home Assistant e começa a adicionar a aplicação.
3. Atribui-lhe um nome, por exemplo my-smart-home, e escolhe uma Box com os recursos adequados.
4. Escolhe um endereço de aplicação disponível. Podes começar com o subdomínio *.saploapp.pl.
5. Confirma a instalação e aguarda a sua conclusão no painel. O tempo depende, entre outros fatores, do download da imagem e da carga do servidor.
6. Abre o endereço HTTPS exato mostrado na aplicação. A Saplo prepara o Domínio e o certificado SSL durante o arranque.
7. De imediato, avança com o assistente de primeira execução e cria a conta do proprietário.

Utiliza o Domínio visível no painel, sem adicionar a porta 8123. O endereço homeassistant.local, encontrado em guias de instalação doméstica, não é o endereço da tua aplicação na Saplo.

Primeiro início de sessão e definições da casa

No assistente de nova instalação, introduz o nome de utilizador e uma palavra-passe forte e única. Criarás a conta do proprietário do Home Assistant por conta própria, e esta é independente da conta no painel Saplo. Guarda os dados no gestor de palavras-passe e não deixes o assistente incompleto num endereço público.

Define a localização da casa, verifica o fuso horário Europe/Warsaw e as unidades. Introduz a localização dos dispositivos que queres controlar, e não o centro de dados. Isso é importante para as horas do nascer e do pôr do sol. Escolhe as definições de partilha de dados e conclui a configuração. O processo do assistente é descrito na documentação de primeiro arranque.

Primeira integração sem hardware adicional

Primeiro, adiciona a integração Workday para os dias úteis. Isso permitir-te-á testar a integração sem uma conta de fabricante e sem uma ligação à rede doméstica.

1. Abre Definições > Dispositivos e serviços.
2. Escolhe adicionar uma integração e procura por Workday.
3. Define Portugal como país e um nome, por exemplo, "Dia útil".
4. Verifica os dias da semana selecionados e as definições de feriados. Deixa o deslocamento de dias em zero se quiseres verificar o dia atual.
5. Conclui a configuração, abre a integração adicionada e verifica o estado das suas entidades.

Uma entidade representa uma leitura ou função específica, neste caso, informações sobre um dia útil. As instruções para adicionar o Workday podem ser encontradas no guia oficial de integração. Adiciona as integrações seguintes individualmente e verifica a sua documentação antes de fornecer os dados de login.

Primeira automatização e verificação de funcionamento

Prepara um teste que exiba uma notificação no próprio Home Assistant numa hora selecionada. Não requer telefone, lâmpada ou sensor.

1. Abre Definições > Automatizações e cenas, adiciona uma automatização e escolhe criar uma regra vazia.
2. Adiciona um acionador de tempo, definindo a hora para alguns minutos depois da hora atual na zona configurada.
3. Para efeitos de teste, deixa a secção de condições vazia.
4. Adiciona a ação persistent_notification.create. Define o título "Teste Saplo" e o conteúdo "A automatização funciona".
5. Grava a regra como "Teste de notificação" e certifica-te de que está ativada.
6. Espera até à hora selecionada. Verifica a notificação na interface do Home Assistant e o rasto de execução da automatização.
7. Após um teste bem-sucedido, desativa ou elimina a regra de teste para que não seja executada diariamente.

O editor está descrito na documentação de automatização, e os campos de ação podem ser encontrados na documentação de Notificação Persistente. Esta é uma notificação dentro do painel, não uma mensagem push para o telefone.

A execução manual da ação ajuda a verificar a sua configuração, mas não confirma o funcionamento do acionador de tempo. Por isso, espera também pela execução agendada. Em seguida, termina a sessão, inicia sessão novamente e verifica se a integração e a regra gravada ainda estão visíveis.

O que verificar quando algo não funciona

A página não abre após a instalação. Verifica o estado da aplicação no Painel Saplo e o endereço HTTPS completo. Se vires um erro, indica ao Suporte Saplo o nome da aplicação, a hora da tentativa e a mensagem. Não elimines uma instalação que já contém uma configuração apenas para tentar novamente.

O Home Assistant não encontra dispositivos em casa. Isso é esperado com esta receita. Verifica se a integração selecionada usa a cloud do fabricante ou se requer uma ligação direta ao dispositivo. Para uma ligação local, precisas de uma rota de rede disponível e de uma integração que suporte esse modo de operação. Não exponhas o painel do dispositivo à internet como uma solução alternativa para o problema.

A automatização não inicia a horas. Verifica o fuso horário, a ativação da regra e a hora definida. Abre o rasto de execução para ver se a regra foi acionada e em que passo parou.

Não existe loja de complementos. Esta é uma característica da instalação Container. Os tutoriais que requerem o Supervisor e os complementos do Home Assistant OS não se aplicam diretamente a esta instalação.

Backups e expansão futura

O Box M não inclui backup no preço do plano. Certifica-te de que fazes backup dos dados e da configuração do Home Assistant fora da tua Box, especialmente antes de uma atualização ou de uma alteração importante. Guardar as automatizações ou ter um diretório de configuração persistente não substitui um backup. Além disso, verifica se consegues restaurar o backup antes de confiares à instalação a gestão diária da tua casa.

Após o primeiro teste bem-sucedido, adiciona uma integração de cada vez e observa a utilização dos recursos. Lançar o Painel não significa que todos os dispositivos estão acessíveis. Verifica cada ligação e cada automatização separadamente.

Se o Home Assistant precisar de aceder a dispositivos em casa sem os expor à internet, uma rede VPN privada será útil. Descrevemos como configurar o Headscale, o teu próprio servidor Tailscale, no Saplo.

Para começar, escolhe Home Assistant no Saplo na Box M por 63 € anuais. Executa o assistente, adiciona o Workday e faz um teste de notificação. Depois, seleciona as integrações para os teus dispositivos e a forma como te ligas à tua casa.