Posso testar antes de conectar um celular?
Sim, se você consegue rodar o Docker. O perfil demo do mesmo arquivo compose inicia a stack com 60 dias de dados fictícios de dois celulares, com nome e portas próprios. Os comandos estão em Rodar a stack. Sem o Docker, as capturas de tela desta página mostram os mesmos dashboards.
Preciso clonar o repositório?
Não. O instalador baixa o docker-compose.yml da versão e grava o .env, e o receptor, o Postgres, o Grafana e o servidor MCP são imagens publicadas para amd64 e arm64. Um clone só serve para mudar o próprio receptor, as views ou os dashboards: um segundo arquivo compose compila então as imagens a partir dele.
Os meus dados são enviados para algum lugar?
Não. Não existe servidor do Life Dashboard nem conta: os celulares enviam para o seu receptor, e os dados ficam no seu Postgres. Os relatórios de uso e as verificações de atualização do Grafana estão desligados. Os dados só saem quando você mesmo conecta alguma coisa, como um modelo na nuvem via MCP, um script com o token da API ou um proxy reverso que você abre para a internet.
A minha IA consegue ler os dados?
Só se você deixar. Inicie o servidor MCP opcional com um MCP_TOKEN, e um modelo que você conecta ganha oito ferramentas somente leitura para os celulares, o que eles têm armazenado, quando sincronizaram pela última vez, dias, noites, treinos, tendências e tempo de tela. Ele lê como dash_ro, então não consegue gravar, apagar nem rodar SQL próprio. Com um modelo local pelo Ollama, tudo fica no seu hardware; com um modelo na nuvem, incluindo o Claude Desktop, as suas perguntas e todos os resultados das ferramentas vão para esse provedor. Conexão Saúde e Apple Health via MCP traz a configuração.
Ela roda no Kubernetes?
Sim, com um Helm chart para o Helm 3 ou 4. Por padrão o Postgres roda como um cluster do CloudNativePG, com réplicas se você quiser e backups em armazenamento de objetos pelo plugin Barman Cloud. Sem o CloudNativePG, o chart roda o Postgres como um único pod incluído ou usa um Postgres que você já roda. Os pods atendem ao Pod Security Standard restricted, e as NetworkPolicies, um Ingress e as rotas da Gateway API são opcionais. docs/kubernetes.md traz os passos.
Posso colocá-la na internet?
Coloque um proxy reverso com TLS na frente do receptor, encaminhe só /webhook e permita corpos de requisição de 32 MB. A API divide a porta com o receptor, e /pair mostra o segredo de assinatura: o receptor só responde a /pair para a sua própria rede e nunca por um proxy, mas um proxy que não adiciona nenhum cabeçalho de encaminhamento, ou o redirecionamento de portas do Docker Desktop, pode fazer uma requisição de fora parecer local, então bloqueie o caminho ali ou defina PAIRING_PAGE=0. Mantenha o Grafana e o servidor MCP na sua própria rede ou atrás de uma VPN: qualquer pessoa que consiga ver um dashboard consegue ler todos os registros de saúde. Antes da primeira inicialização, troque GRAFANA_PASSWORD, GRAFANA_DB_PASSWORD e DASH_DB_PASSWORD no .env. O Postgres não publica nenhuma porta, então só os serviços da própria stack chegam até ele.
Posso usá-la ao lado do Home Assistant?
Sim, como uma segunda casa para os dados. Cada endereço no app tem o seu próprio segredo de assinatura (Android a partir da 1.28.0, iPhone a partir da 1.10.0), e o pareamento só define o segredo para o endereço que ele adiciona, então pareie com o Home Assistant e com a stack e cada um mantém o seu. Um ponto para saber: um payload conta como entregue assim que um destino o aceita, então, se a stack estiver fora do ar naquele momento, ela fica sem esse payload.
Como eu atualizo?
Defina LIFEDASH_VERSION no .env com a nova versão, depois rode docker compose pull && docker compose up -d. Defina só a versão principal, e cada pull acompanha as versões que mantêm a compatibilidade. Dentro de uma versão principal, os payloads, o banco de dados, as views dash, os usuários somente leitura, as configurações e as portas continuam iguais, como lista o docs/compatibility.md. Uma instalação mais antiga feita a partir de um clone migra os dados uma única vez com um script que deixa o volume antigo intacto; o README traz os passos.
Como eu faço o backup?
Com o Docker Compose, uma linha de pg_dump grava um dump, e uma linha de pg_restore o coloca em uma stack nova. Reinicie o receptor em seguida para ele recriar as views e as permissões dos usuários somente leitura. No Kubernetes com o CloudNativePG, os backups vão para o armazenamento de objetos em uma agenda, e uma restauração inicia um novo cluster a partir deles.
Posso mudar os dashboards?
Sim. Eles vêm dentro da imagem do Grafana, então o Grafana não salva mudanças por cima deles, e uma atualização traz as novas versões. Use Save as para ter uma cópia sua, que uma atualização não toca. Para mudar os originais, edite o JSON em um clone e compile as imagens a partir dele. Guarde as suas próprias views no schema public, porque o receptor recria dash a cada inicialização.
Já rodo o Grafana. Posso usar o meu?
Sim. Rode o receptor e o Postgres da stack, e no seu próprio Grafana adicione uma fonte de dados PostgreSQL para o banco de dados da stack, com o usuário somente leitura grafana_ro e a sua GRAFANA_DB_PASSWORD. Depois importe os seis arquivos de dashboard de grafana/dashboards/life-dashboard/ e escolha essa fonte de dados. O grafana_ro consegue ler os registros, os buckets e as views dash, e mais nada.
O que ela ainda não faz?
As séries enviadas por janela de tempo são armazenadas, mas só os painéis de frequência cardíaca as leem, então deixe Resolução dos dados em Todos os registros. Os dias seguem o único fuso horário da stack, e um backfill (o envio de todo o histórico de uma vez) não remove registros que o celular não tem mais. A API e o servidor MCP respondem por dia, noite e treino, não com registros brutos. As lacunas conhecidas listam o resto.