Seus dados de saúde no seu próprio Postgres e Grafana

A stack Life Dashboard é um backend de código aberto para os dois apps: um receptor que confere as assinaturas, o Postgres e seis dashboards do Grafana. Um único comando faz a instalação, cada celular é pareado por QR code, e uma API somente leitura e um servidor MCP devolvem os dados para os seus scripts e para uma IA que você escolhe.

Rodar com o Docker ComposeHelm chart no Artifact Hub

Dados de demonstração

No GitHub: 14 estrelas, 2 forks, 1 colaborador. 751 pulls da imagem do banco de dados. Atualizado a cada hora.

O dashboard de visão geral da stack do Grafana com dados de demonstração

O que faz

Um comando para instalar

O instalador baixa o docker-compose.yml da versão, grava o .env com um segredo e senhas aleatórios e inicia a stack. As imagens são publicadas para amd64 e arm64, então nada é clonado nem compilado.

  • Pareamento por QR code

    Como na integração do Home Assistant: o receptor mostra um código, o app o escaneia, e você não digita nem o endereço nem o segredo.

  • Seis dashboards

    Overview, Activity, Sleep, Heart and body, Screen time e Data and sync, em uma pasta Life Dashboard, cada um com um seletor Phone.

  • Todos os registros no Postgres

    O receptor confere o HMAC do X-Signature, aplica uma só vez um payload repetido e remove o que o celular informa como apagado.

  • Seus dados de volta

    Uma API JSON somente leitura com um token próprio, para um script, um widget ou uma planilha: dias, noites, treinos, tempo de tela e tendências.

  • Pergunte à sua própria IA

    Um servidor MCP opcional com oito ferramentas somente leitura, para um modelo local ou o Claude. Nenhuma ferramenta grava, e nenhuma aceita SQL.

Sono, atividade, coração e tempo de tela no Grafana

Todo dashboard tem um seletor Phone e links para os outros cinco que mantêm o intervalo de tempo. Cada painel tem um ícone de informação que diz de onde vem o número.

  • Life Dashboard overview Como foram o dia de hoje e a última noite, e esta semana contra as quatro anteriores.
  • Activity e Sleep Passos por hora, minutos de treino contra a recomendação de 150 da OMS, um hipnograma, a hora de dormir e a de acordar.
  • Heart and body Frequência cardíaca por hora, frequência cardíaca em repouso, VFC, SpO2, frequência respiratória e peso com a média de 7 dias.
  • Screen time, Data and sync Minutos por app e por dia, o último uso antes de dormir, e quando cada celular enviou dados pela última vez.
Os seis dashboards
O dashboard de sono da stack do Grafana
Instalar
GH=https://github.com/owen282000/life-dashboard-stack
curl -fsSL $GH/releases/latest/download/install.sh | sh
# files in ./life-dashboard, then the pairing code

# something wrong? the same line, ending in
#   | sh -s -- doctor

Um comando, e um QR code para cada celular

O instalador coloca o docker-compose.yml da versão em uma pasta própria, grava o .env com um segredo e senhas aleatórios, inicia a stack e mostra o código de pareamento. O receptor, o Postgres e o Grafana vêm como imagens publicadas, então nada é compilado.

  • Em um servidor doméstico ou em um Raspberry Pi Qualquer máquina com Docker e Compose que o seu celular alcance. As imagens são publicadas para amd64 e arm64, então um Raspberry Pi com sistema de 64 bits consegue rodá-las; 32 bits não é suportado.
  • Pareamento como no Home Assistant Com PUBLIC_URL definido, o receptor imprime um QR code no log, e /pair o mostra como uma página, só para a sua própria rede.
  • Um rótulo por celular Cada celular ganha o seu próprio código e o seu próprio Phone nos dashboards, então um celular Android e um iPhone ficam lado a lado.
  • Atualizações que continuam funcionando Defina LIFEDASH_VERSION com a nova versão, depois baixe as imagens e inicie de novo. Dentro de uma versão principal, as suas consultas, os seus painéis e o seu .env continuam funcionando.
O início rápido

Sem pontuações, e uma lacuna onde faltam dados

Nada é colorido como bom ou ruim. As metas são linhas tracejadas que você pode mudar no topo de um dashboard.

  • Passos contados uma vez só Passos, distância e calorias vêm dos totais diários do celular, então uma caminhada registrada pelo celular e pelo relógio conta uma vez só.
  • Dias locais no seu fuso horário Uma noite pertence à manhã em que você acorda. O dia de hoje é marcado como “so far” (até agora) e fica fora das médias.
  • VFC mantida separada A RMSSD de um relógio Android e a SDNN de um Apple Watch são medidas diferentes, então nunca são misturadas.
  • Lacunas, não zeros Um dia sem dados aparece como uma lacuna. O único vermelho é um celular que não enviou nada por 24 horas.
O dashboard de atividade da stack do Grafana

Seus dados de volta, em SQL ou em JSON

As views dash têm uma linha por dia, noite, hora ou app, com os dias locais já calculados. Consulte-as com o psql, em um painel do Grafana feito por você ou pela API somente leitura. Cada view, coluna e unidade está documentada.

  • dash.activity_days e dash.sleep_nights Passos por dia, contados uma vez só, e horas dormindo, de sono profundo e de REM por noite, por celular.
  • Uma API JSON somente leitura Com API_TOKEN definido, /api/ responde com dias, noites, treinos, tempo de tela, uma métrica como série ou uma tendência contra o período anterior.
  • Usuários somente leitura O Grafana lê como grafana_ro, a API e o servidor MCP como dash_ro. Nenhum dos dois consegue gravar, e as consultas deles param depois de 30 e de 15 segundos.
  • Desligada até você querer Sem um token, todo caminho abaixo de /api/ responde 404. Atrás de um proxy reverso, encaminhe só /webhook se você não precisa da API do lado de fora.
Todos os endpoints da API
O dashboard de dados e sincronização da stack do Grafana
Iniciar o servidor MCP
echo "MCP_TOKEN=$(openssl rand -hex 32)" >> .env
docker compose --profile mcp up -d

# then, in your MCP client:
# URL     http://<this machine>:8090/mcp
# Header  Authorization: Bearer <MCP_TOKEN>

Pergunte à sua própria IA, por um servidor MCP somente leitura

Uma quarta imagem, opcional, dá a um modelo que você escolhe oito ferramentas somente leitura: list_phones, data_catalog, sync_status, daily_summary, sleep_nights, workouts, trend e screen_time. Ela fala Streamable HTTP com um bearer token, para o Open WebUI, o LM Studio ou qualquer cliente MCP, e stdio para o Claude Desktop na mesma máquina.

  • Somente leitura de ponta a ponta As ferramentas leem as views dash como dash_ro. Não há ferramenta que grave nem ferramenta que aceite SQL, então um modelo não consegue mudar nem apagar nada.
  • Um modelo local mantém tudo em casa Com o Ollama e um cliente de chat que fale MCP, as perguntas, os dados e as respostas ficam no seu hardware.
  • Um modelo na nuvem vê o que ele pede Com o Claude ou o ChatGPT, incluindo o Claude Desktop, as suas perguntas e todos os resultados das ferramentas vão para esse provedor.
  • Nada por conta própria A stack não envia nada a nenhuma IA. O servidor só responde a um cliente que você conecta com o seu MCP_TOKEN.
Conecte um modelo, passo a passo
Instalar com o Helm
# CloudNativePG first, once per cluster
helm install lifedash \
  oci://ghcr.io/owen282000/charts/life-dashboard \
  -n life-dashboard --create-namespace \
  -f my-values.yaml --wait --timeout 10m
helm test lifedash -n life-dashboard --logs

Um Helm chart para o seu próprio cluster

O chart roda as mesmas imagens. Por padrão, o Postgres vem do CloudNativePG, com réplicas, failover e backups em armazenamento de objetos. Sem o operador, um StatefulSet incluído ou um Postgres que você já roda também funcionam.

  • Segredos criados uma vez Gerados na primeira instalação e mantidos em cada atualização, ou lidos de um Secret seu, vindo por exemplo do Sealed Secrets, do External Secrets ou do SOPS.
  • Pod Security restricted Pods sem root, com sistema de arquivos raiz somente leitura e sem token de conta de serviço. As NetworkPolicies estão lá para quando você as ativar.
  • Backups em armazenamento de objetos Pelo plugin Barman Cloud do CloudNativePG: um backup base em uma agenda e o WAL entre um e outro, então uma restauração pode voltar a um momento específico.
  • Só /webhook do lado de fora Por padrão, o Ingress ou a rota da Gateway API abre apenas /webhook. O helm test confere o receptor, os dashboards, a API e o servidor MCP.
O chart, do CloudNativePG à desinstalação

Rodar a stack

Stack Life Dashboard

Postgres, Grafana, uma API e MCP, no seu servidor

Rodar com o Docker Compose

Baixe o docker-compose.yml e o .env de exemplo da versão mais recente, defina o segredo, seu fuso horário, o endereço e as senhas, e rode docker compose up -d. Nada para clonar nem compilar.

  • Dados de demonstração Disponível60 dias de dados fictícios de dois celulares, com o mesmo arquivo compose, antes de envolver qualquer celular seu.
  • Helm chart no Artifact HubAs mesmas imagens em um cluster seu, com Postgres do CloudNativePG, um StatefulSet incluído ou um banco de dados que você já roda.

O que você precisa

Docker com Compose, em uma máquina que o seu celular alcance na mesma rede ou por uma VPN: um servidor doméstico, um NAS ou um Raspberry Pi com sistema de 64 bits, já que as imagens são publicadas só para amd64 e arm64. Ou um cluster Kubernetes com Helm 3 ou 4, com o CloudNativePG para o Postgres padrão. Em cada celular, o Life Dashboard para Android ou para iPhone, pareado por QR code ou apontado para a URL de webhook do receptor na porta 8080, com um rótulo para aquele celular e o mesmo segredo de WEBHOOK_SECRET. Defina esse segredo: sem ele o receptor aceita payloads sem assinatura e não mostra nenhum código de pareamento. Para alcançar o receptor de fora, coloque um proxy reverso com TLS na frente dele. A stack é oferecida como um ponto de partida que você pode modificar, não como um produto acabado.

Recebe do Life Dashboard para Android e para iPhone.

Teste com dados de demonstração
mkdir lifedash-demo && cd lifedash-demo
GH=https://github.com/owen282000/life-dashboard-stack
curl -fsSLO $GH/releases/latest/download/docker-compose.yml
RECEIVER_PORT=18080 GRAFANA_PORT=13000 \
  docker compose -p lifedash-demo \
  --profile demo up -d

Espere um minuto, depois abra http://localhost:13000 e entre como admin com a senha de demonstração lifedash. docker compose -p lifedash-demo --profile demo down -v remove tudo. Para os seus próprios dados, o início rápido traz o instalador de uma linha.

Perguntas sobre a stack

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.