ENPLDEPT
Flash
Toda a documentação
Sensmos Hub

O seu node roda na máquina que você já tem — sem ESP32.

Um container em um Raspberry Pi, NAS ou servidor doméstico. Ele entra na rede como um node, mede a sua conexão e abre o mesmo túnel criptografado para o Home Assistant que um node físico.

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

  1. Configurações → Add-ons → Loja de add-ons → ⋮ → Repositórios → adicione https://github.com/sensmos-network/sensmos-hub.
  2. Instale Sensmos Hub, preencha owner (o endereço da carteira) e opcionalmente pin, inicie.
  3. O log do add-on mostra o id do node e o PIN.

Pareamento e o painel do HA

  1. 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.
  2. 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.
  3. 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):

arquivoo que é
identity.jsono par de chaves do hub; apague para obter uma nova identidade (um novo node)
pairing.jsonchaves de pareamento gravadas pelos celulares
pin.txto PIN, quando você não definiu um

Perguntas, respostas diretas

O hub ganha GALU?

Não. Ele não tem rádio, então não retransmite nada nem amplia a cobertura; as recompensas vão para os nodes que fazem isso. O hub existe para o túnel, as medições e, mais adiante, para guardar os dados dos seus sensores em casa.

Posso ter um hub e um node ESP32 ao mesmo tempo?

Sim. São nodes separados na mesma carteira. O hub é um bom lugar para o túnel quando os seus nodes ESP32 ficam na bateria ou longe do Home Assistant.

O servidor vê o meu tráfego do Home Assistant?

Não. O túnel é criptografado de ponta a ponta com uma chave derivada da chave de pareamento, que o celular grava no hub apenas pela sua rede local. O servidor encaminha quadros ilegíveis e não consegue abrir um túnel sozinho.

Quanto custa?

Uma taxa fixa de 0,5 GALU no dia em que você usa o túnel, como em um node físico. O hub em si é gratuito. Com saldo vazio nada é bloqueado.

Atualizado: 2026-11-01