Tus datos de salud en tu propio Postgres y Grafana

El stack de Life Dashboard es un backend de código abierto para las dos apps: un receptor que comprueba las firmas, Postgres y seis dashboards de Grafana. Se instala con un comando, cada teléfono se vincula con un código QR, y una API de solo lectura y un servidor MCP devuelven los datos a tus scripts y a la IA que elijas.

Ejecutar con Docker ComposeChart de Helm en Artifact Hub

Datos de demostración

En GitHub: 14 estrellas, 2 forks, 1 colaborador. 751 descargas de la imagen de la base de datos. Se actualiza cada hora.

El dashboard de resumen del stack de Grafana con datos de demostración

Qué hace

Un comando para instalarlo

El instalador descarga el docker-compose.yml de la versión, escribe el .env con un secreto y contraseñas aleatorios y arranca el stack. Las imágenes están publicadas para amd64 y arm64, así que no hay nada que clonar ni compilar.

  • Vinculación con un código QR

    Como en la integración de Home Assistant: el receptor muestra un código, la app lo escanea y no escribes ni la dirección ni el secreto.

  • Seis dashboards

    Overview, Activity, Sleep, Heart and body, Screen time y Data and sync, en una carpeta Life Dashboard, cada uno con un selector Phone.

  • Cada registro en Postgres

    El receptor comprueba el HMAC de X-Signature, aplica una sola vez un payload repetido y elimina lo que el teléfono comunica como borrado.

  • Tus datos, de vuelta

    Una API JSON de solo lectura con su propio token, para un script, un widget o una hoja de cálculo: días, noches, entrenamientos, tiempo de pantalla y tendencias.

  • Pregúntale a tu propia IA

    Un servidor MCP opcional con ocho herramientas de solo lectura, para un modelo local o Claude. Ninguna herramienta escribe y ninguna acepta SQL.

Sueño, actividad, corazón y tiempo de pantalla en Grafana

Cada dashboard tiene un selector Phone y enlaces a los otros cinco que conservan el intervalo de tiempo. Cada panel tiene un icono de información que dice de dónde sale su cifra.

  • Life Dashboard overview Cómo fueron el día de hoy y la última noche, y esta semana frente a las cuatro anteriores.
  • Activity y Sleep Pasos por hora, minutos de entrenamiento frente a la recomendación de 150 de la OMS, un hipnograma, la hora de acostarse y la de despertarse.
  • Heart and body Frecuencia cardíaca por hora, frecuencia cardíaca en reposo, HRV, SpO2, frecuencia respiratoria y peso con su media de 7 días.
  • Screen time, Data and sync Minutos por app y por día, el último uso antes de dormir y cuándo envió datos cada teléfono por última vez.
Los seis dashboards
El dashboard de sueño del stack de Grafana
Instalación
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

Un comando, y un código QR para cada teléfono

El instalador pone el docker-compose.yml de la versión en una carpeta propia, escribe el .env con un secreto y contraseñas aleatorios, arranca el stack y muestra el código de vinculación. El receptor, Postgres y Grafana vienen como imágenes publicadas, así que no se compila nada.

  • En un servidor doméstico o una Raspberry Pi Cualquier equipo con Docker y Compose al que tu teléfono pueda llegar. Las imágenes están publicadas para amd64 y arm64, así que una Raspberry Pi con un sistema de 64 bits puede ejecutarlas; 32 bits no es compatible.
  • Vinculación como en Home Assistant Con PUBLIC_URL configurado, el receptor imprime un código QR en su log, y /pair lo muestra como una página solo a tu propia red.
  • Una etiqueta por teléfono Cada teléfono tiene su propio código y su propio Phone en los dashboards, así que un teléfono Android y un iPhone aparecen uno al lado del otro.
  • Actualizaciones que no rompen nada Pon LIFEDASH_VERSION en la versión nueva, y después descarga las imágenes y arranca de nuevo. Dentro de una versión mayor, tus propias consultas, tus paneles y tu .env siguen funcionando.
El inicio rápido

Sin puntuaciones, y un hueco donde faltan datos

Nada se colorea como bueno o malo. Los objetivos son líneas discontinuas que puedes cambiar en la parte superior de un dashboard.

  • Los pasos se cuentan una vez Los pasos, la distancia y las calorías salen de los totales diarios del teléfono, así que un paseo registrado por el teléfono y el reloj se cuenta una sola vez.
  • Días locales en tu zona horaria Una noche pertenece a la mañana en que te despiertas. El día de hoy se marca como “so far” y queda fuera de las medias.
  • La HRV, por separado El RMSSD de un reloj Android y el SDNN de un Apple Watch son medidas distintas, así que nunca se mezclan.
  • Huecos, no ceros Un día que falta se muestra como un hueco. El único rojo es un teléfono que no envió nada en 24 horas.
El dashboard de actividad del stack de Grafana

Tus datos de vuelta, en SQL o como JSON

Las vistas dash tienen una fila por día, noche, hora o app, con los días locales ya calculados. Consúltalas con psql, en un panel de Grafana tuyo o a través de la API de solo lectura. Cada vista, columna y unidad está documentada.

  • dash.activity_days y dash.sleep_nights Pasos por día, contados una vez, y horas dormidas, de sueño profundo y REM por noche, por teléfono.
  • Una API JSON de solo lectura Con API_TOKEN configurado, /api/ responde con días, noches, entrenamientos, tiempo de pantalla, una métrica como serie o una tendencia frente al periodo anterior.
  • Usuarios de solo lectura Grafana lee como grafana_ro, y la API y el servidor MCP como dash_ro. Ninguno puede escribir, y sus consultas se cortan a los 30 y a los 15 segundos.
  • Desactivada hasta que la quieras Sin un token, cada ruta bajo /api/ es un 404. Detrás de un proxy inverso, reenvía solo /webhook si no necesitas la API desde fuera.
Todos los endpoints de la API
El dashboard de datos y sincronización del stack de Grafana
Arrancar el 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>

Pregúntale a tu propia IA, con un servidor MCP de solo lectura

Una cuarta imagen opcional le da al modelo que elijas ocho herramientas de solo lectura: list_phones, data_catalog, sync_status, daily_summary, sleep_nights, workouts, trend y screen_time. Habla Streamable HTTP con un token bearer, para Open WebUI, LM Studio o cualquier cliente MCP, y stdio para Claude Desktop en el mismo equipo.

  • Solo lectura de principio a fin Las herramientas leen las vistas dash como dash_ro. No hay ninguna herramienta que escriba ni ninguna que acepte SQL, así que un modelo no puede cambiar ni borrar nada.
  • Con un modelo local, todo se queda en casa Con Ollama y un cliente de chat que hable MCP, las preguntas, los datos y las respuestas se quedan en tu equipo.
  • Un modelo en la nube ve lo que pide Con Claude o ChatGPT, incluido Claude Desktop, tus preguntas y el resultado de cada herramienta van a ese proveedor.
  • Nada por su cuenta El stack no envía nada a ninguna IA. El servidor solo responde a un cliente que conectas con tu MCP_TOKEN.
Conectar un modelo, paso a paso
Instalar con 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 de Helm para tu propio clúster

El chart ejecuta las mismas imágenes. De forma predeterminada, Postgres lo pone CloudNativePG, con réplicas, failover y copias de seguridad en almacenamiento de objetos. Sin el operador, también sirven un StatefulSet incluido o un Postgres que ya tengas.

  • Secretos que se crean una vez Se generan en la primera instalación y se conservan en cada actualización, o se toman de un Secret tuyo, por ejemplo de Sealed Secrets, External Secrets o SOPS.
  • Pod Security restricted Pods sin root, con el sistema de archivos raíz de solo lectura y sin token de cuenta de servicio. Las NetworkPolicies están ahí para cuando las actives.
  • Copias de seguridad en almacenamiento de objetos Con el plugin Barman Cloud de CloudNativePG: una copia base programada y el WAL entre medias, así que una restauración puede volver a un momento concreto.
  • Solo /webhook hacia fuera La ruta de Ingress o de Gateway API abre solo /webhook de forma predeterminada. helm test comprueba el receptor, los dashboards, la API y el servidor MCP.
El chart, desde CloudNativePG hasta la desinstalación

Ejecutar el stack

Stack de Life Dashboard

Postgres, Grafana, una API y MCP, autoalojado

Ejecutar con Docker Compose

Descarga docker-compose.yml y el .env de ejemplo de la última versión, configura el secreto, tu zona horaria, la dirección y las contraseñas, y después docker compose up -d. No hay nada que clonar ni compilar.

  • Datos de demostración Disponible60 días de datos inventados para dos teléfonos, con el mismo archivo compose, antes de que intervenga ningún teléfono tuyo.
  • Chart de Helm en Artifact HubLas mismas imágenes en tu propio clúster, con Postgres de CloudNativePG, un StatefulSet incluido o una base de datos que ya tengas.

Qué necesitas

Docker con Compose, en un equipo al que tu teléfono pueda llegar en la misma red o por una VPN: un servidor doméstico, un NAS o una Raspberry Pi con un sistema de 64 bits, ya que las imágenes solo están publicadas para amd64 y arm64. O un clúster de Kubernetes con Helm 3 o 4, con CloudNativePG para el Postgres predeterminado. En cada teléfono, Life Dashboard para Android o para iPhone, vinculado con un código QR o apuntando a la URL del webhook del receptor en el puerto 8080, con una etiqueta para ese teléfono y el mismo secreto que WEBHOOK_SECRET. Configura ese secreto: sin él, el receptor acepta payloads sin firmar y no muestra ningún código de vinculación. Para llegar al receptor desde fuera, ponle delante un proxy inverso con TLS. El stack se ofrece como un punto de partida que puedes modificar, no como un producto terminado.

Recibe de Life Dashboard para Android y para iPhone.

Pruébalo con datos de demostración
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

Espera un minuto, abre http://localhost:13000 e inicia sesión como admin con la contraseña de demostración lifedash. docker compose -p lifedash-demo --profile demo down -v lo elimina todo. Para tus propios datos, el inicio rápido tiene el instalador de una sola línea.

Preguntas sobre el stack

¿Puedo probarlo antes de conectar un teléfono?

Sí, si puedes ejecutar Docker. El perfil demo del mismo archivo compose arranca el stack con 60 días de datos inventados para dos teléfonos, con su propio nombre y sus propios puertos. Los comandos están en Ejecutar el stack. Sin Docker, las capturas de esta página muestran los mismos dashboards.

¿Tengo que clonar el repositorio?

No. El instalador descarga el docker-compose.yml de la versión y escribe el .env, y el receptor, Postgres, Grafana y el servidor MCP son imágenes publicadas para amd64 y arm64. Clonar solo hace falta para cambiar el receptor, las vistas o los propios dashboards: un segundo archivo compose compila entonces las imágenes a partir del clon.

¿Se envían mis datos a algún sitio?

No. No hay ningún servidor de Life Dashboard ni ninguna cuenta: los teléfonos envían a tu receptor y los datos se quedan en tu Postgres. Los informes de uso y las comprobaciones de actualizaciones de Grafana están desactivados. Los datos solo salen cuando tú mismo conectas algo, como un modelo en la nube por MCP, un script con el token de la API o un proxy inverso que abres a internet.

¿Puede mi IA leer los datos?

Solo si se lo permites. Arranca el servidor MCP opcional con un MCP_TOKEN, y el modelo que conectes tendrá ocho herramientas de solo lectura para los teléfonos, lo que tienen guardado, cuándo sincronizaron por última vez, los días, las noches, los entrenamientos, las tendencias y el tiempo de pantalla. Lee como dash_ro, así que no puede escribir, borrar ni ejecutar SQL propio. Con un modelo local a través de Ollama, todo se queda en tu equipo; con un modelo en la nube, incluido Claude Desktop, tus preguntas y el resultado de cada herramienta van a ese proveedor. Health Connect y Apple Health por MCP explica la configuración.

¿Funciona en Kubernetes?

Sí, con un chart de Helm para Helm 3 o 4. De forma predeterminada, Postgres se ejecuta como un clúster de CloudNativePG, con réplicas si las quieres y copias de seguridad en almacenamiento de objetos mediante el plugin Barman Cloud. Sin CloudNativePG, el chart ejecuta Postgres como un único pod incluido o usa un Postgres que ya tengas. Los pods cumplen el Pod Security Standard restricted, y las NetworkPolicies, un Ingress y las rutas de Gateway API son opcionales. docs/kubernetes.md tiene los pasos.

¿Puedo exponerlo a internet?

Pon un proxy inverso con TLS delante del receptor, reenvía solo /webhook y permite cuerpos de petición de 32 MB. La API comparte el puerto del receptor, y /pair muestra el secreto de firma: el receptor solo responde a /pair desde tu propia red y nunca a través de un proxy, pero un proxy que no agrega ningún encabezado de reenvío, o el reenvío de puertos de Docker Desktop, pueden hacer que una petición de fuera parezca local, así que bloquéala ahí o configura PAIRING_PAGE=0. Deja Grafana y el servidor MCP en tu propia red o detrás de una VPN: cualquiera que pueda ver un dashboard puede leer todos los registros de salud. Antes del primer arranque, cambia GRAFANA_PASSWORD, GRAFANA_DB_PASSWORD y DASH_DB_PASSWORD en el .env. Postgres no publica ningún puerto, así que solo llegan a él los servicios del propio stack.

¿Puedo usarlo junto a Home Assistant?

Sí, como un segundo hogar para los datos. Cada dirección de la app tiene su propio secreto de firma (Android desde la 1.28.0, iPhone desde la 1.10.0), y la vinculación solo configura el secreto de la dirección que agrega, así que vincula con Home Assistant y con el stack y cada uno conserva el suyo. Algo que conviene saber: un payload se da por entregado en cuanto un destino lo acepta, así que si el stack no responde en ese momento, se pierde ese payload.

¿Cómo lo actualizo?

Pon LIFEDASH_VERSION en el .env con la versión nueva y ejecuta docker compose pull && docker compose up -d. Si pones solo la versión mayor, cada descarga sigue las versiones que mantienen la compatibilidad. Dentro de una versión mayor, los payloads, la base de datos, las vistas dash, los usuarios de solo lectura, la configuración y los puertos no cambian, como detalla docs/compatibility.md. Una instalación antigua hecha desde un clon traslada sus datos una vez con un script que deja intacto el volumen anterior; el README tiene los pasos.

¿Cómo hago una copia de seguridad?

Con Docker Compose, una línea de pg_dump escribe un volcado y una línea de pg_restore lo carga en un stack nuevo. Reinicia después el receptor para que reconstruya las vistas y los permisos de los usuarios de solo lectura. En Kubernetes con CloudNativePG, las copias de seguridad van a un almacenamiento de objetos de forma programada, y una restauración arranca un clúster nuevo a partir de ellas.

¿Puedo cambiar los dashboards?

Sí. Van incluidos en la imagen de Grafana, así que Grafana no guarda cambios encima de ellos, y una actualización trae sus versiones nuevas. Usa Save as para tener una copia propia, que una actualización no toca. Para cambiar los originales, edita el JSON en un clon y compila las imágenes a partir de él. Guarda tus propias vistas en el esquema public, porque el receptor reconstruye dash en cada arranque.

Ya tengo Grafana. ¿Puedo usar el mío?

Sí. Ejecuta el receptor y Postgres del stack, y en tu propio Grafana agrega una fuente de datos PostgreSQL para la base de datos del stack con el usuario de solo lectura grafana_ro y tu GRAFANA_DB_PASSWORD. Después importa los seis archivos de dashboards de grafana/dashboards/life-dashboard/ y elige esa fuente de datos. grafana_ro puede leer los registros, los buckets y las vistas dash, y nada más.

¿Qué no hace todavía?

Las series enviadas por ventana de tiempo se guardan, pero solo las leen los paneles de frecuencia cardíaca, así que deja Resolución de datos en Cada registro. Los días siguen la única zona horaria del stack, y un backfill no elimina los registros que el teléfono ya no tiene. La API y el servidor MCP responden por día, noche y entrenamiento, no con registros en bruto. Las carencias conocidas enumeran el resto.