O que você precisa
- Docker com Compose em uma máquina sempre ligada e na mesma rede local que o Home Assistant, ou Home Assistant OS / Supervised para o add-on.
- O app Sensmos com uma carteira. O hub é registrado no endereço de carteira que você informar.
Docker
git clone https://github.com/sensmos-network/sensmos-hub.git
cd sensmos-hub
cp .env.example .env # coloque o endereço da sua carteira em HUB_OWNER
docker compose up -d
docker compose logs -f # mostra o device_id e o PIN
O container usa a rede do host: o app alcança o hub na porta 80 (encontrado por mDNS como sensmos-<id>.local, como um node ESP32) para parear, o túnel alcança a sua rede local e o ping mede a conexão real de casa.
Depois do primeiro início o hub aparece no app na lista de nodes dessa carteira.
Add-on do Home Assistant
- Configurações → Add-ons → Loja de add-ons → ⋮ → Repositórios → adicione
https://github.com/sensmos-network/sensmos-hub. - Instale Sensmos Hub, preencha owner (o endereço da carteira) e opcionalmente pin, inicie.
- O log do add-on mostra o id do node e o PIN.
Pareamento e o painel do HA
- No app abra o hub → Configurações → Acesso remoto → Parear com o celular no mesmo Wi-Fi. Digite o PIN. O app grava uma chave de pareamento no hub; a chave nunca sai da sua rede.
- No cartão do node adicione a integração Painel HA e aponte para o endereço local do Home Assistant, por exemplo
192.168.1.20:8123. Com o add-on, é a máquina em que ele roda. - A partir daí o painel abre de qualquer lugar, pelo hub. Acesso remoto explica o túnel em detalhe; as regras são as mesmas: só endereços privados, sem redirecionamento de portas, só para o dono.
O que ele faz hoje
- Registra-se na sua carteira e mantém uma conexão de saída criptografada com a rede, como um node.
- Mede a sua conexão até âncoras (ping, TCP, HTTP, DNS); os resultados alimentam o mesmo mapa e os mesmos relatórios de conexão que os outros nodes.
- Pareia com até quatro celulares e abre o túnel v2 para endereços privados na sua rede.
Ainda não: rádio LoRa por USB, broker MQTT local e buffer de dados, histórico local de sensores, mapa offline. São os próximos passos do roadmap.
Arquivos
Tudo de que o hub precisa fica na pasta de dados (./data no Docker, o armazenamento do add-on no Home Assistant):
| arquivo | o que é |
|---|---|
identity.json | o par de chaves do hub; apague para obter uma nova identidade (um novo node) |
pairing.json | chaves de pareamento gravadas pelos celulares |
pin.txt | o PIN, quando você não definiu um |