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.