¿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.