Vos données de santé dans votre propre Postgres et Grafana

La stack Life Dashboard est un backend open source pour les deux applications : un récepteur qui vérifie les signatures, Postgres et six tableaux de bord Grafana. Une seule commande l’installe, chaque téléphone s’associe par QR code, et une API en lecture seule et un serveur MCP rendent les données à vos scripts et à l’IA de votre choix.

Lancer avec Docker ComposeChart Helm sur Artifact Hub

Données de démonstration

Sur GitHub: 14 étoiles, 2 forks, 1 contributeur. 751 téléchargements de l’image de la base de données. Mis à jour toutes les heures.

Le tableau de bord de vue d’ensemble de la stack Grafana avec des données de démonstration

Ce qu’elle fait

Une seule commande pour l’installer

L’installeur récupère le docker-compose.yml de la version, écrit le .env avec un secret et des mots de passe aléatoires, et démarre la stack. Les images sont publiées pour amd64 et arm64 : rien à cloner ni à compiler.

  • Association par QR code

    Comme pour l’intégration Home Assistant : le récepteur affiche un code, l’application le scanne, et vous ne saisissez ni l’adresse ni le secret.

  • Six tableaux de bord

    Overview, Activity, Sleep, Heart and body, Screen time et Data and sync (vue d’ensemble, activité, sommeil, cœur et corps, temps d’écran, données et synchronisation), dans un dossier Life Dashboard, chacun avec un sélecteur Phone.

  • Chaque enregistrement dans Postgres

    Le récepteur vérifie le HMAC de l’en-tête X-Signature, n’applique qu’une fois un payload répété et supprime ce que le téléphone signale comme supprimé.

  • Vos données en retour

    Une API JSON en lecture seule avec son propre jeton, pour un script, un widget ou un tableur : jours, nuits, entraînements, temps d’écran et tendances.

  • Interrogez votre propre IA

    Un serveur MCP facultatif avec huit outils en lecture seule, pour un modèle local ou Claude. Aucun outil n’écrit, et aucun n’accepte de SQL.

Sommeil, activité, cœur et temps d’écran dans Grafana

Chaque tableau de bord a un sélecteur Phone et des liens vers les cinq autres qui conservent la période affichée. Chaque panneau a une icône d’information qui indique d’où vient son chiffre.

  • Life Dashboard overview Le déroulement de la journée et de la nuit dernière, et cette semaine face aux quatre précédentes.
  • Activity et Sleep Les pas par heure, les minutes d’entraînement face à la recommandation de 150 de l’OMS, un hypnogramme, l’heure du coucher et celle du réveil.
  • Heart and body La fréquence cardiaque par heure, la fréquence cardiaque au repos, la variabilité de la fréquence cardiaque, la SpO2, la fréquence respiratoire et le poids avec sa moyenne sur 7 jours.
  • Screen time, Data and sync Les minutes par application et par jour, la dernière utilisation avant le sommeil, et le dernier envoi de données de chaque téléphone.
Les six tableaux de bord
Le tableau de bord du sommeil de la stack Grafana
Installation
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

Une seule commande, et un QR code pour chaque téléphone

L’installeur place le docker-compose.yml de la version dans un dossier dédié, écrit le .env avec un secret et des mots de passe aléatoires, démarre la stack et affiche le code d’association. Le récepteur, Postgres et Grafana sont des images publiées : rien n’est compilé.

  • Sur un serveur domestique ou un Raspberry Pi N’importe quelle machine avec Docker et Compose que votre téléphone peut joindre. Les images sont publiées pour amd64 et arm64 : un Raspberry Pi avec un système 64 bits peut donc les faire tourner ; le 32 bits n’est pas pris en charge.
  • Associée comme Home Assistant Avec PUBLIC_URL défini, le récepteur affiche un QR code dans son journal, et /pair le présente sous forme de page, à votre propre réseau uniquement.
  • Un libellé par téléphone Chaque téléphone a son propre code et sa propre entrée Phone dans les tableaux de bord : un téléphone Android et un iPhone y figurent côte à côte.
  • Des mises à jour qui ne cassent rien Indiquez la nouvelle version dans LIFEDASH_VERSION, puis récupérez les images et redémarrez. Au sein d’une version majeure, vos propres requêtes, vos panneaux et votre .env continuent de fonctionner.
Le démarrage rapide

Pas de score, et un vide là où les données manquent

Rien n’est coloré en bon ou en mauvais. Les objectifs sont des lignes en pointillés que vous pouvez modifier en haut d’un tableau de bord.

  • Des pas comptés une seule fois Les pas, la distance et les calories viennent des totaux quotidiens du téléphone : une marche enregistrée par le téléphone et la montre ne compte qu’une fois.
  • Des jours locaux dans votre fuseau horaire Une nuit appartient au matin où vous vous réveillez. La journée en cours est marquée « so far » et exclue des moyennes.
  • La variabilité de la fréquence cardiaque à part Le RMSSD d’une montre Android et le SDNN d’une Apple Watch sont des mesures différentes : elles ne sont donc jamais mélangées.
  • Des vides, pas des zéros Un jour manquant apparaît comme un vide. Le seul rouge signale un téléphone qui n’a rien envoyé depuis 24 heures.
Le tableau de bord d’activité de la stack Grafana

Vos données en retour, en SQL ou en JSON

Les vues dash contiennent une ligne par jour, nuit, heure ou application, avec les jours locaux déjà calculés. Interrogez-les avec psql, dans un panneau Grafana à vous, ou par l’API en lecture seule. Chaque vue, chaque colonne et chaque unité est documentée.

  • dash.activity_days et dash.sleep_nights Les pas par jour, comptés une seule fois, et les heures de sommeil, de sommeil profond et de sommeil paradoxal par nuit, par téléphone.
  • Une API JSON en lecture seule Avec API_TOKEN défini, /api/ renvoie les jours, les nuits, les entraînements, le temps d’écran, une mesure sous forme de série, ou une tendance par rapport à la période précédente.
  • Des utilisateurs en lecture seule Grafana lit en tant que grafana_ro, l’API et le serveur MCP en tant que dash_ro. Aucun des deux ne peut écrire, et leurs requêtes s’arrêtent après 30 et 15 secondes.
  • Désactivée tant que vous n’en voulez pas Sans jeton, chaque chemin sous /api/ renvoie un 404. Derrière un reverse proxy, ne transmettez que /webhook si vous n’avez pas besoin de l’API à l’extérieur.
Tous les points d’accès de l’API
Le tableau de bord données et synchronisation de la stack Grafana
Démarrer le serveur 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>

Interrogez votre propre IA, par un serveur MCP en lecture seule

Une quatrième image, facultative, donne au modèle de votre choix huit outils en lecture seule : list_phones, data_catalog, sync_status, daily_summary, sleep_nights, workouts, trend et screen_time. Il parle Streamable HTTP avec un jeton bearer, pour Open WebUI, LM Studio ou n’importe quel client MCP, et stdio pour Claude Desktop sur la même machine.

  • En lecture seule de bout en bout Les outils lisent les vues dash en tant que dash_ro. Aucun outil n’écrit et aucun n’accepte de SQL : un modèle ne peut donc rien modifier ni supprimer.
  • Avec un modèle local, tout reste chez vous Avec Ollama et un client de discussion qui parle MCP, les questions, les données et les réponses restent sur votre matériel.
  • Un modèle dans le cloud voit ce qu’il demande Avec Claude ou ChatGPT, Claude Desktop compris, vos questions et chaque résultat d’outil vont à ce fournisseur.
  • Rien de sa propre initiative La stack n’envoie rien à aucune IA. Le serveur ne répond qu’à un client que vous connectez avec votre MCP_TOKEN.
Connecter un modèle, pas à pas
Installer avec 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

Un chart Helm pour votre propre cluster

Le chart fait tourner les mêmes images. Postgres est fourni par défaut par CloudNativePG, avec des réplicas, la bascule automatique et des sauvegardes vers un stockage objet. Sans l’opérateur, un StatefulSet inclus ou un Postgres que vous exploitez déjà conviennent aussi.

  • Des secrets créés une seule fois Générés à la première installation et conservés à chaque mise à jour, ou repris d’un Secret à vous, issu par exemple de Sealed Secrets, d’External Secrets ou de SOPS.
  • Pod Security restricted Des pods non root, avec un système de fichiers racine en lecture seule et sans jeton de compte de service. Les NetworkPolicies sont là dès que vous les activez.
  • Des sauvegardes vers un stockage objet Par le plugin Barman Cloud de CloudNativePG : une sauvegarde de base planifiée et les WAL entre deux, pour qu’une restauration puisse revenir à un instant précis.
  • Seul /webhook est exposé La route Ingress ou Gateway API n’ouvre par défaut que /webhook. helm test vérifie le récepteur, les tableaux de bord, l’API et le serveur MCP.
Le chart, de CloudNativePG à la désinstallation

Lancer la stack

Stack Life Dashboard

Postgres, Grafana, une API et MCP, auto-hébergés

Lancer avec Docker Compose

Téléchargez docker-compose.yml et l’exemple de .env de la dernière version, renseignez le secret, votre fuseau horaire, l’adresse et les mots de passe, puis lancez docker compose up -d. Rien à cloner ni à compiler.

  • Données de démonstration Disponible60 jours de données fictives pour deux téléphones, avec le même fichier compose, avant même d’y connecter l’un des vôtres.
  • Chart Helm sur Artifact HubLes mêmes images sur votre propre cluster, avec Postgres fourni par CloudNativePG, un StatefulSet inclus ou une base de données que vous exploitez déjà.

Ce qu’il vous faut

Docker avec Compose, sur une machine que votre téléphone peut joindre sur le même réseau ou par un VPN : un serveur domestique, un NAS ou un Raspberry Pi avec un système 64 bits, car les images ne sont publiées que pour amd64 et arm64. Ou un cluster Kubernetes avec Helm 3 ou 4, et CloudNativePG pour le Postgres par défaut. Sur chaque téléphone, Life Dashboard pour Android ou pour iPhone, associée par QR code ou dirigée vers l’URL de webhook du récepteur sur le port 8080, avec un libellé pour ce téléphone et le même secret que WEBHOOK_SECRET. Définissez ce secret : sans lui, le récepteur accepte les payloads non signés et n’affiche aucun code d’association. Pour joindre le récepteur de l’extérieur, placez devant lui un reverse proxy avec TLS. La stack est proposée comme un point de départ que vous pouvez modifier, pas comme un produit fini.

Reçoit les données de Life Dashboard pour Android et pour iPhone.

L’essayer avec des données de démonstration
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

Patientez une minute, puis ouvrez http://localhost:13000 et connectez-vous en tant que admin avec le mot de passe de démonstration lifedash. docker compose -p lifedash-demo --profile demo down -v supprime le tout. Pour vos propres données, le démarrage rapide présente l’installeur en une ligne.

Questions sur la stack

Puis-je l’essayer avant de connecter un téléphone ?

Oui, si vous pouvez faire tourner Docker. Le profil de démonstration du même fichier compose démarre la stack avec 60 jours de données fictives pour deux téléphones, sous son propre nom et ses propres ports. Les commandes se trouvent sous Lancer la stack. Sans Docker, les captures d’écran de cette page montrent les mêmes tableaux de bord.

Dois-je cloner le dépôt ?

Non. L’installeur récupère le docker-compose.yml de la version et écrit le .env, et le récepteur, Postgres, Grafana et le serveur MCP sont des images publiées pour amd64 et arm64. Un clone ne sert qu’à modifier le récepteur, les vues ou les tableaux de bord eux-mêmes : un second fichier compose construit alors les images à partir de celui-ci.

Mes données sont-elles envoyées quelque part ?

Non. Il n’y a ni serveur Life Dashboard ni compte : les téléphones envoient vers votre récepteur, et les données restent dans votre Postgres. Les rapports d’utilisation et les vérifications de mise à jour de Grafana sont désactivés. Les données ne sortent que si vous connectez vous-même quelque chose, comme un modèle dans le cloud par MCP, un script avec le jeton de l’API, ou un reverse proxy que vous ouvrez sur Internet.

Mon IA peut-elle lire les données ?

Seulement si vous l’y autorisez. Démarrez le serveur MCP facultatif avec un MCP_TOKEN, et le modèle que vous connectez obtient huit outils en lecture seule pour les téléphones, ce qu’ils ont enregistré, leur dernière synchronisation, les jours, les nuits, les entraînements, les tendances et le temps d’écran. Il lit en tant que dash_ro : il ne peut donc ni écrire, ni supprimer, ni exécuter son propre SQL. Avec un modèle local sous Ollama, tout reste sur votre matériel ; avec un modèle dans le cloud, Claude Desktop compris, vos questions et chaque résultat d’outil vont à ce fournisseur. Le guide Santé Connect et Apple Santé via MCP décrit la mise en place.

Fonctionne-t-elle sur Kubernetes ?

Oui, avec un chart Helm pour Helm 3 ou 4. Par défaut, Postgres tourne sous forme de cluster CloudNativePG, avec des réplicas si vous en voulez et des sauvegardes vers un stockage objet par le plugin Barman Cloud. Sans CloudNativePG, le chart fait tourner Postgres dans un pod inclus ou utilise un Postgres que vous exploitez déjà. Les pods respectent le Pod Security Standard restricted, et les NetworkPolicies, un Ingress et les routes Gateway API sont facultatifs. Les étapes sont dans docs/kubernetes.md.

Puis-je l’exposer sur Internet ?

Placez un reverse proxy avec TLS devant le récepteur, ne transmettez que /webhook et autorisez des corps de requête de 32 Mo. L’API partage le port du récepteur, et /pair affiche le secret de signature : le récepteur ne répond à /pair que pour votre propre réseau et jamais à travers un proxy, mais un proxy qui n’ajoute aucun en-tête de transfert, ou la redirection de ports de Docker Desktop, peut faire passer une requête extérieure pour une requête locale. Bloquez donc ce chemin à ce niveau ou définissez PAIRING_PAGE=0. Gardez Grafana et le serveur MCP sur votre propre réseau ou derrière un VPN : quiconque peut voir un tableau de bord peut lire chaque enregistrement de santé. Avant le premier démarrage, changez GRAFANA_PASSWORD, GRAFANA_DB_PASSWORD et DASH_DB_PASSWORD dans le .env. Postgres ne publie aucun port : seuls les services de la stack peuvent donc le joindre.

Puis-je l’utiliser à côté de Home Assistant ?

Oui, comme second emplacement pour les données. Chaque adresse dans l’application a son propre secret de signature (Android à partir de la version 1.28.0, iPhone à partir de la 1.10.0), et l’association ne définit le secret que pour l’adresse qu’elle ajoute : associez donc Home Assistant et la stack, et chacun garde le sien. Une chose à savoir : un payload compte comme livré dès qu’une destination l’accepte ; si la stack est indisponible à ce moment-là, elle manque ce payload.

Comment la mettre à jour ?

Indiquez la nouvelle version dans LIFEDASH_VERSION dans le .env, puis lancez docker compose pull && docker compose up -d. Si vous n’indiquez que la version majeure, chaque récupération suit les versions qui restent compatibles. Au sein d’une version majeure, les payloads, la base de données, les vues dash, les utilisateurs en lecture seule, les réglages et les ports restent les mêmes, comme le détaille docs/compatibility.md. Une installation plus ancienne faite à partir d’un clone transfère ses données une fois, avec un script qui laisse l’ancien volume intact ; les étapes sont dans le README.

Comment la sauvegarder ?

Avec Docker Compose, une ligne pg_dump écrit une sauvegarde, et une ligne pg_restore la charge dans une stack neuve. Redémarrez ensuite le récepteur pour qu’il reconstruise les vues et les droits des utilisateurs en lecture seule. Sur Kubernetes avec CloudNativePG, les sauvegardes partent vers un stockage objet selon une planification, et une restauration démarre un nouveau cluster à partir d’elles.

Puis-je modifier les tableaux de bord ?

Oui. Ils sont intégrés à l’image Grafana : Grafana n’enregistre donc pas de modifications par-dessus, et une mise à jour apporte leurs nouvelles versions. Utilisez Save as pour en faire votre propre copie, qu’une mise à jour laisse intacte. Pour modifier les originaux, éditez le JSON dans un clone et construisez les images à partir de celui-ci. Gardez vos propres vues dans le schéma public, car le récepteur reconstruit dash à chaque démarrage.

J’ai déjà un Grafana. Puis-je utiliser le mien ?

Oui. Faites tourner le récepteur et Postgres de la stack et, dans votre propre Grafana, ajoutez une source de données PostgreSQL pour la base de la stack avec l’utilisateur en lecture seule grafana_ro et votre GRAFANA_DB_PASSWORD. Importez ensuite les six fichiers de tableaux de bord depuis grafana/dashboards/life-dashboard/ et choisissez cette source de données. grafana_ro peut lire les enregistrements, les fenêtres agrégées et les vues dash, et rien d’autre.

Que ne fait-elle pas encore ?

Les séries envoyées par fenêtre de temps sont enregistrées, mais seuls les panneaux de fréquence cardiaque les lisent : laissez donc Résolution des données sur Chaque enregistrement. Les jours suivent l’unique fuseau horaire de la stack, et un backfill ne supprime pas les enregistrements que le téléphone n’a plus. L’API et le serveur MCP répondent par jour, par nuit et par entraînement, pas avec des enregistrements bruts. Les lacunes connues énumèrent le reste.