sparkyfitness
SparkyFitness es un rastreador de fitness autoalojado con enfoque en privacidad, diseñado para FreeBSD. Utiliza Node.js y PostgreSQL como backend, compatible con múltiples orquestadores de contenedores.
Ficha actualizada 28 sept 2026, 7:13 · upstream 28 sept 2026, 7:08 · release sin release detectada
Qué es sparkyfitness
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
SparkyFitness es una aplicación de seguimiento de actividad física diseñada para ejecutarse en entornos autoalojados, particularmente optimizada para FreeBSD. La arquitectura separa el backend Node.js del frontend mediante nginx, permitiendo despliegues modulares y escalables.
El sistema utiliza PostgreSQL como base de datos principal, con soporte para múltiples instancias mediante puertos personalizados (5433 por defecto) para evitar conflictos con otros servicios como Immich. Incluye autenticación mediante BETTER_AUTH y cifrado de API opcional mediante claves hexadecimales.
La aplicación soporta gestión de archivos de usuario (fotos de perfil, imágenes de ejercicios) y respaldos locales. El despliegue es compatible con Podman Compose, AppJail Director, Podman CLI, AppJail y Bastille, ofreciendo flexibilidad según el entorno del host.
- Seguimiento de actividad física personal en servidor doméstico sin enviar datos a terceros
- Gestión de rutinas de ejercicio con almacenamiento local de imágenes de progreso
- Integración en ecosistemas FreeBSD mediante orquestadores nativos como Podman o AppJail
- Proyecto educativo sobre despliegue de aplicaciones Node.js con PostgreSQL en entornos autoalojados
- Enfoque privacy-first: datos almacenados localmente sin sincronización automática con servicios externos
- Compatibilidad multi-orquestador: Podman Compose, AppJail Director, Bastille y CLI nativo
- Puertos PostgreSQL personalizados (5433) para coexistencia con otros servicios en modo host-networking
- Soporte para FreeBSD mediante scripts de inicio automático vía podman rc.d
- Autenticación integrada con BETTER_AUTH para gestión segura de sesiones
- Requiere FreeBSD como sistema operativo base según descripción oficial del proyecto
- Bastille OCI support marcado como experimental en la documentación
- Configuración manual obligatoria de variables de entorno sin soporte one-click completo
- Dependencia de ghcr.io/daemonless/postgres:18 para la instancia de base de datos sidecar
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Recomendado usar Podman Compose con network_mode: host y puertos PostgreSQL distintos por servicio. Configurar SPARKY_FITNESS_DB_PORT=5433 si coexiste con otros servicios Postgres en el mismo host. Asegurar UPLOADS_LOCATION y BACKUPS_LOCATION con rutas persistentes. Generar claves de cifrado aleatorias para SPARKY_FITNESS_API_ENCRYPTION_KEY antes del despliegue.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.