SparkyFitness Backend
SparkyFitness Backend is the self-hosted API and data-storage container for SparkyFitness, a privacy-first fitness tracking platform that helps users monitor…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
78/100 Good
- Maintained
- 100last commit 12 days ago
- Popular
- 776,741 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 52 days ago
- GitHub stars
- 6,741
- Open issues
- 191
- Last commit
- 2026-11-09
- Latest release
- v1.11.0
- Activity
- steady
Checked 12 days ago - source: GitHub (CodeWithCJ/SparkyFitness)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Set up the .env file first Download the production docker-compose file and the example .env file, then open .env and fill in the database address, user, password, and port. The .env file holds secrets and database settings, so if these are missing or wrong the app cannot store fitness data or start properly. source
- Start the app with Docker Compose Run docker compose pull && docker compose up -d; Docker Compose is the tool that starts all app pieces together, and this command downloads them and runs them in the background. Without this the app is not running; when it succeeds, open http://localhost:3004 in a browser. source
- Prepare an external database if used If you point SparkyFitness at your own PostgreSQL database, run the provided SQL to create the required database extensions and update .env with those details. PostgreSQL extensions are extra database features; skipping them can cause the app to fail when it tries to save or look up data. source
- Pair with frontend Pair the backend with the SparkyFitness Frontend container to provide the web interface. source
Fetched 37 days ago - each note links to its source
Variants
Alternatives (9)
- ASICS Runkeeper - Just like a real-life coach, the ASICS Runkeeper app will help you set your goals, train for them, and track your progress along the way.
- Cronometer - An online diary for tracking your diet, exercise, and other health related information.
- FitoTrack - FitoTrack is a mobile app for logging and viewing your workouts.
- Google Fit - Google Fit is a health-tracking platform developed by Google for the Android operating system.
- MyFitnessPal - Lose weight with MyFitnessPal, the fastest and easiest-to-use calorie counter.With the largest food database of any calorie counter, and am…
- OpenNutriTracker - OpenNutriTracker is an open-source mobile application designed to simplify nutritional tracking and management.
- OpenTracks - OpenTracks is a sport tracking application that completely respects your privacy.
- Sobers - Sobers is a recovery and sobriety accountability app.
- Strava - Strava makes fitness tracking social.
Checked 51 days ago - source: AlternativeTo
Common questions
Can SparkyFitness be installed through Unraid Community Apps?
No, the SparkyFitness container is not available in the Community Apps.
Which file must be configured before starting SparkyFitness with Docker Compose?
The .env file must be filled in with the database address, user, password, and port. It holds the secrets and database settings.
What command starts the SparkyFitness app pieces in the background?
Run docker compose pull && docker compose up -d. This downloads the pieces and runs them together.
On what port should the app be opened after a successful start?
Open the app in a browser on port 3004 of the local host.
What must be done when pointing SparkyFitness at an external PostgreSQL database?
Run the provided SQL to create the required database extensions and update .env with those details. Skipping the extensions can make the app fail when saving or looking up data.
Answers sourced from codewithcj.github.io, codewithcj.github.io, forums.unraid.net
Community
- SparkyFitness - Help installing a container not available on the ... (forum)
- Reddit (reddit)
- Help/guide for SparkyFitness - Docker Engine - Unraid (forum)
Collected 49 days ago - public community threads