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…

  • Other
  • Productivity
  • Tools & Utilities
SparkyFitness Backend is the self-hosted API and data-storage container for SparkyFitness, a privacy-first fitness tracking platform that helps users monitor nutrition, exercise, and body measurements.

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

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

Collected 49 days ago - public community threads