Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
A self-hosted fitness and nutrition tracker built for households: food logging, exercise, water, sleep, fasting, mood and body measurements, with goals, daily check-ins and long-term charts, and separate profiles with family access. It has a web app, mobile apps and Apple Watch and Wear OS companions, and supports OIDC, TOTP and passkeys. It is source-available under a non-commercial licence, not open source.
Runs on a VPS from $6/mo (Kamatera 2GB, 2 GB RAM) · prices checked Nov 2026
Fits home hardware (527 MB measured idle, RAM only): Raspberry Pi 4 (4 GB) (arm64 untested), Raspberry Pi 5 (8 GB) (arm64 untested), Repurposed laptop (8 GB), Intel N100 mini PC (16 GB), AMD Ryzen mini PC (32 GB).
Pick SparkyFitness when you want one tracker for a whole household: food and nutrition logging, exercise, water, sleep, fasting, mood and body measurements, with goals, daily check-ins, long-term charts, separate profiles and family access, plus Apple Watch and Wear OS companion apps. The licence is the catch: the README says plainly that it is source-available, not open source, and the LICENSE allows non-commercial use only and requires the author's permission for commercial use. Our snippet is the project's `docker-compose.prod.yml` (PostgreSQL, a Node.js server and an Nginx frontend) with both app images pinned to v1.11.0 (published 2026-10-30) and every secret generated into `.env`. We did not find an upstream RAM minimum, so our 512 MB floor is an estimate. The catalog's wger is the AGPL workout-planning and nutrition manager, Endurain and Workout Tracker are GPS activity logs; SparkyFitness is the one aimed at food, body and family tracking.
Paid link — we earn a commission if you shop through it.
Run these commands on your server:
# SparkyFitness — family fitness tracker — based on the project's docker-compose.prod.yml, pinned to v1.11.0
mkdir -p postgresql backup uploads
echo "SPARKY_FITNESS_DB_PASSWORD=$(openssl rand -hex 16)" > .env
echo "SPARKY_FITNESS_API_ENCRYPTION_KEY=$(openssl rand -hex 32)" >> .env
echo "BETTER_AUTH_SECRET=$(openssl rand -base64 32)" >> .env
echo "SPARKY_FITNESS_FRONTEND_URL=http://localhost:3004" >> .env
cat > docker-compose.yml <<'EOF'
services:
sparkyfitness-db:
image: postgres:18.3-alpine
restart: unless-stopped
environment:
POSTGRES_DB: sparkyfitness_db
POSTGRES_USER: sparky
POSTGRES_PASSWORD: ${SPARKY_FITNESS_DB_PASSWORD}
volumes:
- ./postgresql:/var/lib/postgresql
healthcheck:
test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
interval: 10s
timeout: 5s
retries: 10
start_period: 30s
sparkyfitness-server:
image: codewithcj/sparkyfitness_server:v1.11.0
restart: unless-stopped
depends_on:
sparkyfitness-db:
condition: service_healthy
environment:
SPARKY_FITNESS_DB_HOST: sparkyfitness-db
SPARKY_FITNESS_DB_PORT: 5432
SPARKY_FITNESS_DB_NAME: sparkyfitness_db
SPARKY_FITNESS_DB_USER: sparky
SPARKY_FITNESS_DB_PASSWORD: ${SPARKY_FITNESS_DB_PASSWORD}
SPARKY_FITNESS_APP_DB_USER: sparky_app
SPARKY_FITNESS_FRONTEND_URL: ${SPARKY_FITNESS_FRONTEND_URL}
SPARKY_FITNESS_API_ENCRYPTION_KEY: ${SPARKY_FITNESS_API_ENCRYPTION_KEY}
BETTER_AUTH_SECRET: ${BETTER_AUTH_SECRET}
NODE_ENV: production
TZ: Etc/UTC
SPARKY_FITNESS_SERVER_PORT: 3010
PUID: 1000
GUID: 1000
volumes:
- ./backup:/app/SparkyFitnessServer/backup
- ./uploads:/app/SparkyFitnessServer/uploads
sparkyfitness-frontend:
image: codewithcj/sparkyfitness:v1.11.0
restart: unless-stopped
depends_on:
- sparkyfitness-server
ports:
- 3004:80
environment:
SPARKY_FITNESS_FRONTEND_URL: ${SPARKY_FITNESS_FRONTEND_URL}
SPARKY_FITNESS_SERVER_HOST: sparkyfitness-server
SPARKY_FITNESS_SERVER_PORT: 3010
PUID: 1000
GUID: 1000
EOF
docker compose up -d
timeout 300 bash -c 'until curl -fsS -o /dev/null http://localhost:3004/api/ping; do sleep 3; done'
# → http://SERVER_IP:3004 (register the first account, which becomes admin; set SPARKY_FITNESS_FRONTEND_URL in .env to the URL you browse to, then docker compose up -d)SparkyFitness's LICENSE, Compose file and environment docs flag these before you rely on it:
SparkyFitness used 527 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 512 MB.
The SparkyFitness install snippet is marked verified on Ubuntu 26.04 (Nov 2026).