Cómo instalar Lyftr en Docker - Rastreador de ejercicios autohospedado en Docker

Lyftr | Fitness Tracker | Docker

Lyftr: Rastreador de ejercicios autohospedado moderno en Docker

Registra workouts, construye programas, monitorea progreso. 800+ ejercicios predetectados. Gráficas de tendencias, matriz de consistencia 12 semanas, análisis de equilibrio muscular. Sin suscripción, datos tuyos.

¿Qué es Lyftr?

Lyftr es un rastreador de ejercicios autohospedado moderno y mobile-first que reemplaza aplicaciones de pago como MyFitnessPal, Strong, o StrongBrothers. Diseñado para que registres tus workouts, construyas programas de entrenamiento, y monitores tu progreso sin depender de servidores remotos o pagar suscripciones mensuales.

Filosofía: "Porque pagar $15/mes por una app de fitness es dinero mejor gastado en proteína." Lyftr mantiene todos tus datos en un único archivo SQLite que controlas completamente. Go + Gin backend, React + TypeScript + Tailwind frontend. Viene preconfigurado con biblioteca de 800+ ejercicios. Interfaz moderna, UI responsive, funciona perfectamente en móvil (modo activo durante el workout).

Datos tuyos para siempre: Un único archivo SQLite (lyftr.db) almacena TODO. Sin vendor lock-in, sin suscripción, sin API que cierre mañana. Si decides parar, tienes tus datos. Respaldas una sola carpeta y listo.

Características principales

Registro de workouts

Registra series, repeticiones, peso. Interfaz intuitiva para sesión en el gym.

Modo activo (Active mode)

Dos layouts: Lista y Gym mode. Perfecto para usar durante sesión sin distracciones.

800+ ejercicios

Biblioteca predetectada. Incluye músculos objetivo, variantes, instrucciones.

Constructor de programas

Crea programas reutilizables. Define series objetivo y pesos.

Gráficas de tendencias

Visualiza volumen, fuerza, consistencia a lo largo del tiempo.

Matriz 12 semanas

Heatmap de consistencia. Muestra tus días activos vs sedentarios.

Balance muscular

Diagrama que muestra qué músculos necesitan más trabajo.

Récords personales (PRs)

Guarda automáticamente tu máximo peso levantado por ejercicio.

Tracking de peso

Registra peso corporal con gráfica de tendencias. Soporta lb/kg.

Nutrición (beta)

Tracking de calorías y macros. Búsqueda Open Food Facts, escaneo de código.

Dashboard

Resumen visual de tendencias, próximos workouts, metas del día.

Open Source

MIT License. Comunidad activa, desarrollo continuo, código auditable.

Requisitos del sistema

• Docker instalado
• 512 MB - 1 GB de RAM
• 500 MB - 1 GB espacio en disco
• Puerto 80 (o 3000, configurable)
• Navegador moderno (Chrome, Firefox, Safari, Edge)
• Funcionamiento en móvil recomendado

Beta activa: Lyftr está en desarrollo activo. Espera cambios frecuentes, pero la base de datos es estable. Haz backup regularmente.

Instalación con Docker Compose

Opción 1: Instalación rápida (sin archivo .env personalizado)

mkdir lyftr && cd lyftr curl -o docker-compose.yml \ https://raw.githubusercontent.com/Cawlumm/lyftr/main/docker-compose.yml docker compose up -d

Opción 2: Con archivo .env personalizado (recomendado)

mkdir lyftr && cd lyftr # Descargar docker-compose.yml curl -o docker-compose.yml \ https://raw.githubusercontent.com/Cawlumm/lyftr/main/docker-compose.yml # Descargar archivo .env de ejemplo curl -o .env \ https://raw.githubusercontent.com/Cawlumm/lyftr/main/.env.example # Editar .env: cambiar JWT_SECRET y CORS_ORIGIN nano .env # Iniciar Lyftr docker compose up -d

Archivo .env básico

JWT_SECRET=tu-clave-secreta-aleatoria-64-caracteres CORS_ORIGIN=http://localhost # O tu dominio

Acceder a Lyftr

Abre http://localhost (o tu dominio si usas reverse proxy). Verás interfaz limpia de Lyftr.

Primeros pasos

1. Crear cuenta

1. Click "Sign Up"
2. Email y contraseña
3. Lyftr carga con programas de ejemplo (PPL 8 semanas)

2. Entender la interfaz

• Dashboard: Resumen diario, gráficas, próximos workouts
• Workouts: Historial de sesiones completadas
• Programs: Tus programas de entrenamiento reutilizables
• Exercises: Biblioteca de 800+ movimientos
• Stats: Gráficas de tendencias, matriz, PRs

3. Registrar tu primer workout

1. Dashboard → "Start Workout" o selecciona programa
2. Se abre modo activo con ejercicios predetectados
3. Para cada serie: peso, reps, notas si quieres
4. Click "Finish Set" después de cada serie
5. Click "Finish Workout" al terminar sesión

4. Ver progreso

1. Stats → Elige tipo de gráfico (Volumen, Fuerza, etc)
2. Matriz 12 semanas muestra tu consistencia
3. Balance muscular sugiere qué entrenar más

5. Crear tu programa personalizado

1. Programs → "New Program"
2. Nombre: "Mi PPL", "Strength", etc
3. Añade ejercicios, fija series objetivo y peso
4. Guarda y úsalo en próximos workouts

Características avanzadas

Tracking de peso

1. Dashboard → "Log Weight"
2. Registra peso diario o semanal
3. Gráfica muestra tendencia (promedio 7 días)
4. Soporta lb o kg automáticamente

Nutrition (Beta)

Funcionalidad en desarrollo. Puedes registrar:

• Calorías diarias
• Macros (proteína, carbs, grasas)
• Buscar alimentos en Open Food Facts
• Escanear código de barras de alimentos

Planes predetectados

Lyftr viene con ejemplos:

• PPL (Push/Pull/Legs) 8 semanas
• Upper/Lower splits
• Full body 3x/week
• Edita o clona para personalizarlos

Modo activo "Gym Mode"

Perfecto para usar durante sesión:

• Pantalla grande, letras legibles
• Botones grandes para no fallar
• Minimal distractions, solo lo necesario
• Funciona offline (datos se syncan cuando vuelve online)

Casos de uso

• Entrenamiento personal: Rastreo completo sin pagar suscripción
• Coach de gym: Sigue múltiples atletas (feature futura)
• Hobby enthusiast: Alguien que quiere perfeccionar técnica y progreso
• Transformación corporal: Documentación de cambios con fotos + datos
• Autoexperimentación: Compara ejercicios, variantes, repercusiones
• Privacidad: No quieres que Google/Apple vea tus datos fitness

HTTPS con Caddy (acceso remoto móvil)

Configuración Caddyfile

lyftr.tudominio.com { reverse_proxy localhost:80 }

Actualizar .env para HTTPS

CORS_ORIGIN=https://lyftr.tudominio.com

Acceso remoto seguro

Ahora accedes desde móvil en el gym: https://lyftr.tudominio.com con HTTPS automático.

Perfecto para móvil: Interfaz responsive y rápida. Usa dato móvil en el gym sin problemas. Carga instantánea.

Gestión y mantenimiento

Ver logs

docker compose logs -f

Backup de datos (IMPORTANTE)

# El archivo lyftr.db es TODO tus datos cp ./data/lyftr.db ./data/lyftr.db.backup # Backup comprimido automático tar czf lyftr-backup-$(date +%Y%m%d).tar.gz ./data/

Actualizar a la última versión

docker compose pull docker compose up -d

Reiniciar Lyftr

docker compose restart

Ver espacio usado

du -sh ./data/lyftr.db

Resetear cuenta (si olvidaste contraseña)

Necesitas acceso directo a base de datos SQLite. Opción más fácil: crea nueva cuenta.

Comparativa con alternativas

vs Strong ($3.99/mes)

Lyftr gana: Gratis forever, código abierto, datos tuyos. Strong gana: Más maduro, más usuários, UI pulida.

vs MyFitnessPal ($9.99/mes)

Lyftr gana: Nutrición + workouts integrados, privacidad. MyFitnessPal gana: Librería de alimentos masiva, análisis detallado.

vs Wger (self-hosted gratis)

Lyftr gana: UI más moderna, mobile-first, más simple. Wger gana: Más maduro, más features avanzadas.

Veredicto: Lyftr es perfecto si quieres simplicidad + privacidad + móvil. Es beta, pero es estable para tracking diario.

---

Referencias oficiales

• Lyftr - GitHub Repository
• Lyftr Official Demo
• I Built Lyftr - Dev.to Article
• Docker Official Documentation

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Sígueme en mis redes sociales

Telegram Discord YouTube GitHub Blog Twitter