Je gezondheidsdata in je eigen Postgres en Grafana

De Life Dashboard-stack is een open-source backend voor beide apps: een ontvanger die handtekeningen controleert, Postgres en zes Grafana-dashboards. Je installeert hem met één commando, elke telefoon koppel je met een QR-code, en een alleen-lezen API en een MCP-server geven de data terug aan je scripts en aan een AI die je zelf kiest.

Draaien met Docker ComposeHelm-chart op Artifact Hub

Demodata

Op GitHub: 14 sterren, 2 forks, 1 bijdrager. 751 pulls van de database-image. Elk uur bijgewerkt.

Het overzichtsdashboard van de Grafana-stack met demodata

Wat het doet

Installeren met één commando

Het installatiescript haalt de docker-compose.yml van de release op, schrijft .env met een willekeurig geheim en wachtwoorden, en start de stack. De images staan klaar voor amd64 en arm64, dus je hoeft niets te klonen of te bouwen.

  • Gekoppeld met een QR-code

    Net als bij de Home Assistant-integratie: de ontvanger toont een code, de app scant hem, en je typt het adres en het geheim geen van beide over.

  • Zes dashboards

    Overview, Activity, Sleep, Heart and body, Screen time en Data and sync, in een map Life Dashboard, elk met een keuzelijst Phone.

  • Elke meting in Postgres

    De ontvanger controleert de HMAC in X-Signature, verwerkt een herhaalde payload één keer en verwijdert wat de telefoon als verwijderd meldt.

  • Je data terug

    Een alleen-lezen JSON-API met een eigen token, voor een script, een widget of een spreadsheet: dagen, nachten, work-outs, schermtijd en trends.

  • Vraag het je eigen AI

    Een optionele MCP-server met acht alleen-lezen tools, voor een lokaal model of Claude. Geen enkele tool schrijft, en geen enkele accepteert SQL.

Slaap, activiteit, hart en schermtijd in Grafana

Elk dashboard heeft een keuzelijst Phone en links naar de andere vijf, die de gekozen periode behouden. Elk paneel heeft een info-icoon dat zegt waar het cijfer vandaan komt.

  • Life Dashboard overview Hoe vandaag en afgelopen nacht verliepen, en deze week tegenover de vier ervoor.
  • Activity en Sleep Stappen per uur, work-outminuten tegenover de WHO-richtlijn van 150, een hypnogram, en wanneer je ging slapen en wakker werd.
  • Heart and body Hartslag per uur, hartslag in rust, HRV, SpO2, ademfrequentie en gewicht met het gemiddelde over 7 dagen.
  • Screen time, Data and sync Minuten per app en per dag, het laatste gebruik voor het slapen, en wanneer elke telefoon voor het laatst data stuurde.
Alle zes dashboards
Het slaapdashboard van de Grafana-stack
Installeren
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

Eén commando, en een QR-code voor elke telefoon

Het installatiescript zet de docker-compose.yml van de release in een eigen map, schrijft .env met een willekeurig geheim en wachtwoorden, start de stack en toont de koppelcode. De ontvanger, Postgres en Grafana komen als kant-en-klare images, dus er wordt niets gebouwd.

  • Op een thuisserver of een Raspberry Pi Elke machine met Docker en Compose die je telefoon kan bereiken. De images staan klaar voor amd64 en arm64, dus een Raspberry Pi met een 64-bits besturingssysteem kan ze draaien; 32-bits wordt niet ondersteund.
  • Koppelen zoals bij Home Assistant Is PUBLIC_URL ingesteld, dan zet de ontvanger een QR-code in zijn log, en toont /pair hem als pagina, alleen aan je eigen netwerk.
  • Een label per telefoon Elke telefoon krijgt een eigen code en een eigen Phone in de dashboards, zodat een Android-telefoon en een iPhone naast elkaar staan.
  • Upgrades die blijven werken Zet LIFEDASH_VERSION op de nieuwe release, haal de images op en start opnieuw. Binnen een hoofdversie blijven je eigen query's, panelen en .env werken.
De snelstart

Geen scores, en een gat waar data ontbreekt

Niets krijgt een kleur voor goed of slecht. Doelen zijn stippellijnen die je bovenaan een dashboard kunt aanpassen.

  • Stappen tellen één keer Stappen, afstand en calorieën komen uit de dagtotalen van de telefoon. Een wandeling die telefoon en horloge allebei hebben gemeten telt dus één keer.
  • Lokale dagen in jouw tijdzone Een nacht hoort bij de ochtend waarop je wakker wordt. Vandaag krijgt het label “so far” en telt niet mee in gemiddelden.
  • HRV blijft gescheiden RMSSD van een Android-horloge en SDNN van een Apple Watch zijn verschillende maten, dus ze worden nooit gemengd.
  • Gaten, geen nullen Een ontbrekende dag zie je als een gat. Het enige rood is een telefoon die 24 uur niets heeft gestuurd.
Het activiteitendashboard van de Grafana-stack

Je data terug, in SQL of als JSON

De dash-views bevatten één rij per dag, nacht, uur of app, waarbij de lokale dagen al zijn uitgerekend. Bevraag ze met psql, in een eigen Grafana-paneel of via de alleen-lezen API. Elke view, kolom en eenheid is gedocumenteerd.

  • dash.activity_days en dash.sleep_nights Stappen per dag, één keer geteld, en de uren slaap, diep en REM per nacht, per telefoon.
  • Een alleen-lezen JSON-API Is API_TOKEN ingesteld, dan antwoordt /api/ met dagen, nachten, work-outs, schermtijd, één meetwaarde als reeks, of een trend tegenover de periode ervoor.
  • Alleen-lezen gebruikers Grafana leest als grafana_ro, de API en de MCP-server als dash_ro. Geen van beide kan schrijven, en hun query's stoppen na 30 en 15 seconden.
  • Uit tot je het wilt Zonder token geeft elk pad onder /api/ een 404. Stuur achter een reverse proxy alleen /webhook door als je de API buiten niet nodig hebt.
Elk endpoint van de API
Het dashboard voor data en sync van de Grafana-stack
De MCP-server starten
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>

Vraag het je eigen AI, via een alleen-lezen MCP-server

Een optionele vierde image geeft een model dat je zelf kiest acht alleen-lezen tools: list_phones, data_catalog, sync_status, daily_summary, sleep_nights, workouts, trend en screen_time. De server spreekt Streamable HTTP met een bearer-token, voor Open WebUI, LM Studio of elke andere MCP-client, en stdio voor Claude Desktop op dezelfde machine.

  • Alleen-lezen, van begin tot eind De tools lezen de dash-views als dash_ro. Er is geen tool die schrijft en geen die SQL accepteert, dus een model kan niets wijzigen of verwijderen.
  • Met een lokaal model blijft alles thuis Met Ollama en een chatclient die MCP spreekt blijven de vragen, de data en de antwoorden op je eigen hardware.
  • Een cloudmodel ziet wat het opvraagt Met Claude of ChatGPT, ook via Claude Desktop, gaan je vragen en elk toolresultaat naar die aanbieder.
  • Niets uit zichzelf De stack stuurt niets naar welke AI dan ook. De server antwoordt alleen een client die je zelf verbindt met je MCP_TOKEN.
Een model verbinden, stap voor stap
Installeren met 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

Een Helm-chart voor je eigen cluster

De chart draait dezelfde images. Postgres komt standaard van CloudNativePG, met replica's, failover en back-ups naar object storage. Zonder de operator werkt een meegeleverde StatefulSet of een Postgres die je al hebt draaien ook.

  • Geheimen die één keer worden aangemaakt Gegenereerd bij de eerste installatie en bij elke upgrade behouden, of overgenomen uit een eigen Secret, bijvoorbeeld van Sealed Secrets, External Secrets of SOPS.
  • Pod Security restricted Pods zonder root, met een alleen-lezen root-bestandssysteem en zonder service-accounttoken. NetworkPolicies zijn er zodra je ze aanzet.
  • Back-ups naar object storage Via de Barman Cloud-plugin van CloudNativePG: een basisback-up volgens schema en de WAL daartussen, zodat je kunt terugzetten naar een bepaald moment.
  • Alleen /webhook naar buiten De Ingress of de Gateway API-route opent standaard alleen /webhook. helm test controleert de ontvanger, de dashboards, de API en de MCP-server.
De chart, van CloudNativePG tot verwijderen

De stack draaien

Life Dashboard-stack

Postgres, Grafana, een API en MCP, zelf gehost

Draaien met Docker Compose

Download docker-compose.yml en het voorbeeld van .env uit de nieuwste release, vul het geheim, je tijdzone, het adres en de wachtwoorden in, en voer docker compose up -d uit. Niets om te klonen of te bouwen.

  • Demodata Beschikbaar60 dagen verzonnen data voor twee telefoons, uit hetzelfde compose-bestand, nog voordat er een telefoon van jou aan te pas komt.
  • Helm-chart op Artifact HubDezelfde images op je eigen cluster, met Postgres van CloudNativePG, een meegeleverde StatefulSet of een database die je al hebt draaien.

Wat je nodig hebt

Docker met Compose, op een machine die je telefoon op hetzelfde netwerk of via een VPN kan bereiken: een thuisserver, een NAS of een Raspberry Pi met een 64-bits besturingssysteem, want de images zijn er alleen voor amd64 en arm64. Of een Kubernetes-cluster met Helm 3 of 4, met CloudNativePG voor de standaard-Postgres. Op elke telefoon Life Dashboard voor Android of voor iPhone, gekoppeld met een QR-code of ingesteld op de webhook-URL van de ontvanger op poort 8080, met een label voor die telefoon en hetzelfde geheim als WEBHOOK_SECRET. Stel dat geheim in: zonder geheim accepteert de ontvanger niet-ondertekende payloads en toont hij geen koppelcode. Wil je de ontvanger van buitenaf bereiken, zet er dan een reverse proxy met TLS voor. De stack is bedoeld als startpunt dat je kunt aanpassen, niet als afgewerkt product.

Ontvangt van Life Dashboard voor Android en voor iPhone.

Proberen met demodata
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

Geef het een minuut, open dan http://localhost:13000 en log in als admin met het demowachtwoord lifedash. docker compose -p lifedash-demo --profile demo down -v ruimt alles weer op. Voor je eigen data staat in de snelstart het installatiescript van één regel.

Vragen over de stack

Kan ik het proberen voordat ik een telefoon koppel?

Ja, als je Docker kunt draaien. Het demoprofiel in hetzelfde compose-bestand start de stack met 60 dagen verzonnen data voor twee telefoons, onder een eigen naam en eigen poorten. De commando's staan onder De stack draaien. Zonder Docker laten de schermafbeeldingen op deze pagina dezelfde dashboards zien.

Moet ik de repository klonen?

Nee. Het installatiescript haalt de docker-compose.yml van de release op en schrijft de .env, en de ontvanger, Postgres, Grafana en de MCP-server zijn kant-en-klare images voor amd64 en arm64. Klonen is alleen nodig als je de ontvanger, de views of de dashboards zelf wilt aanpassen: een tweede compose-bestand bouwt de images dan uit je kloon.

Wordt mijn data ergens naartoe gestuurd?

Nee. Er is geen Life Dashboard-server en geen account: de telefoons sturen naar jouw ontvanger, en de data blijft in jouw Postgres. De gebruiksrapportage en updatecontroles van Grafana staan uit. Data gaat alleen de deur uit als je zelf iets aansluit, zoals een cloudmodel via MCP, een script met het API-token, of een reverse proxy die je voor internet openzet.

Kan mijn AI de data lezen?

Alleen als je dat toelaat. Start de optionele MCP-server met een MCP_TOKEN, en een model dat je verbindt krijgt acht alleen-lezen tools voor telefoons, wat ze hebben opgeslagen, wanneer ze voor het laatst synchroniseerden, dagen, nachten, work-outs, trends en schermtijd. De server leest als dash_ro en kan dus niet schrijven, verwijderen of eigen SQL uitvoeren. Met een lokaal model via Ollama blijft alles op je eigen hardware; met een cloudmodel, ook via Claude Desktop, gaan je vragen en elk toolresultaat naar die aanbieder. In Health Connect en Apple Health via MCP staat hoe je het instelt.

Draait het op Kubernetes?

Ja, met een Helm-chart voor Helm 3 of 4. Standaard draait Postgres als CloudNativePG-cluster, met replica's als je die wilt en back-ups naar object storage via de Barman Cloud-plugin. Zonder CloudNativePG draait de chart Postgres als één meegeleverde pod, of gebruikt hij een Postgres die je al hebt draaien. De pods voldoen aan de Pod Security Standard restricted, en NetworkPolicies, een Ingress en Gateway API-routes zijn optioneel. De stappen staan in docs/kubernetes.md.

Kan ik het aan internet hangen?

Zet een reverse proxy met TLS voor de ontvanger, stuur alleen /webhook door en sta request bodies van 32 MB toe. De API deelt de poort van de ontvanger, en /pair toont het ondertekeningsgeheim: de ontvanger beantwoordt /pair alleen voor je eigen netwerk en nooit via een proxy. Maar een proxy die geen forwarding-header toevoegt, of de port forwarding van Docker Desktop, kan een verzoek van buiten lokaal laten lijken. Blokkeer het pad dus daar, of zet PAIRING_PAGE=0. Houd Grafana en de MCP-server op je eigen netwerk of achter een VPN: iedereen die een dashboard kan bekijken, kan elke gezondheidsmeting lezen. Wijzig vóór de eerste start GRAFANA_PASSWORD, GRAFANA_DB_PASSWORD en DASH_DB_PASSWORD in .env. Postgres publiceert geen poort, dus alleen de eigen services van de stack kunnen erbij.

Kan ik het naast Home Assistant gebruiken?

Ja, als tweede plek voor je data. Elk adres in de app heeft een eigen ondertekeningsgeheim (Android vanaf 1.28.0, iPhone vanaf 1.10.0), en koppelen stelt het geheim alleen in voor het adres dat erbij komt. Koppel dus met Home Assistant en met de stack, en elk houdt zijn eigen geheim. Eén ding om te weten: een payload geldt als afgeleverd zodra één bestemming hem aanneemt. Is de stack op dat moment niet bereikbaar, dan mist hij die payload.

Hoe upgrade ik?

Zet LIFEDASH_VERSION in .env op de nieuwe release en voer dan docker compose pull && docker compose up -d uit. Vul je alleen de hoofdversie in, dan volgt elke pull de releases die compatibel blijven. Binnen een hoofdversie blijven de payloads, de database, de dash-views, de alleen-lezen gebruikers, de instellingen en de poorten gelijk, zoals in docs/compatibility.md staat. Een oudere installatie uit een kloon zet zijn data één keer over met een script dat het oude volume ongemoeid laat; de stappen staan in de README.

Hoe maak ik een back-up?

Met Docker Compose schrijft één regel pg_dump een dump, en zet één regel pg_restore hem in een verse stack. Herstart daarna de ontvanger, zodat hij de views en de rechten van de alleen-lezen gebruikers opnieuw opbouwt. Op Kubernetes met CloudNativePG gaan back-ups volgens schema naar object storage, en start een restore daaruit een nieuw cluster.

Kan ik de dashboards aanpassen?

Ja. Ze zitten in de Grafana-image ingebouwd. Grafana slaat wijzigingen er dus niet overheen op, en een upgrade brengt de nieuwe versies mee. Gebruik Save as voor een eigen kopie, die een upgrade met rust laat. Wil je de originelen aanpassen, bewerk dan de JSON in een kloon en bouw de images daaruit. Zet eigen views in het schema public, want de ontvanger bouwt dash bij elke start opnieuw op.

Ik heb al een Grafana draaien. Kan ik die gebruiken?

Ja. Draai de ontvanger en Postgres uit de stack, en voeg in je eigen Grafana een PostgreSQL-databron toe voor de database van de stack, met de alleen-lezen gebruiker grafana_ro en je GRAFANA_DB_PASSWORD. Importeer daarna de zes dashboardbestanden uit grafana/dashboards/life-dashboard/ en kies die databron. grafana_ro kan de metingen, de buckets en de dash-views lezen, en verder niets.

Wat kan het nog niet?

Reeksen die per tijdvenster worden verstuurd worden opgeslagen, maar alleen de hartslagpanelen lezen ze. Laat Dataresolutie dus op Elke meting staan. Dagen volgen de ene tijdzone van de stack, en een backfill verwijdert geen metingen die de telefoon niet meer heeft. De API en de MCP-server antwoorden per dag, nacht en work-out, niet met ruwe metingen. De rest staat bij de known gaps.