SparkyFitness---Backend

SparkyFitness---Backend

Docker app from grtgbln's Repository

Overview

SparkyFitness is a comprehensive fitness tracking and management application designed to help users monitor their nutrition, exercise, and body measurements. It provides tools for daily progress tracking, goal setting, and insightful reports to support a healthy lifestyle.
This is the backend container.

Requirements


        Requires separate SparkyFitness - Frontend and Postgres containers.
    

Runtime arguments

Network
sparkyfitness
Privileged
false

Template configuration

API PortPorttcp

Container Port: 3010

Target
3010
Default
3010
Value
3010
Postgres - HostVariable

Hostname or IP address of the Postgres server

Target
SPARKY_FITNESS_DB_HOST
Default
http://IP_ADDRESS
Value
http://IP_ADDRESS
Postgres - PortVariable

Port number for the Postgres server

Target
SPARKY_FITNESS_DB_PORT
Default
5432
Value
5432
Postgres - Database NameVariable

Name of the Postgres database

Target
SPARKY_FITNESS_DB_NAME
Default
sparkyfitness_db
Value
sparkyfitness_db
Postgres - UsernameVariable

Username for the Postgres database

Target
SPARKY_FITNESS_DB_USER
Postgres - PasswordVariable

Password for the Postgres database

Target
SPARKY_FITNESS_DB_PASSWORD
Postgres - UsernameVariable

Username for the Postgres database

Target
SPARKY_FITNESS_APP_DB_USER
Postgres - PasswordVariable

Password for the Postgres database

Target
SPARKY_FITNESS_APP_DB_PASSWORD
Garmin Microservice URLVariable

URL of the Garmin microservice (e.g., http://IP_ADDRESS:8000)

Target
GARMIN_MICROSERVICE_URL
Default
http://IP_ADDRESS:8000
Value
http://IP_ADDRESS:8000
Frontend URLVariable

URL where the frontend is accessible (e.g., http://IP_ADDRESS:3004)

Target
SPARKY_FITNESS_FRONTEND_URL
Default
http://IP_ADDRESS:3004
Value
http://IP_ADDRESS:3004
Security - Encryption KeyVariable

A 64-character hex string used to encrypt data. Generate with 'openssl rand -hex 32'

Target
SPARKY_FITNESS_API_ENCRYPTION_KEY
Security - SecretVariable

A secret key. Generate with 'openssl rand -base64 32'

Target
BETTER_AUTH_SECRET
Disable User SignupsVariable

Set to true to disable new user registrations

Target
SPARKY_FITNESS_DISABLE_SIGNUP
Default
false|true
Force Email LoginsVariable

Force email/password login to be enabled, overriding any in-app settings. This is a fail-safe to prevent being locked out if OIDC is misconfigured.

Target
SPARKY_FITNESS_FORCE_EMAIL_LOGIN
Default
false|true
Admin EmailVariable

Automatically grant admin rights to this email

Target
SPARKY_FITNESS_ADMIN_EMAIL
Email - SMTP HostVariable

SMTP server hostname for sending emails

Target
SPARKY_FITNESS_EMAIL_HOST
Email - SMTP PortVariable

SMTP server port (default: 587)

Target
SPARKY_FITNESS_EMAIL_PORT
Default
587
Value
587
Email - SMTP SecureVariable

Set to true if the SMTP server requires a secure connection (TLS)

Target
SPARKY_FITNESS_EMAIL_SECURE
Default
false|true
Email - SMTP UserVariable

SMTP server username for authentication

Target
SPARKY_FITNESS_EMAIL_USER
Email - SMTP PasswordVariable

SMTP server password for authentication

Target
SPARKY_FITNESS_EMAIL_PASS
Email - From AddressVariable

Email address that emails will be sent from

Target
SPARKY_FITNESS_EMAIL_FROM
Backup StoragePath

Path to the backup storage folder

Target
/app/SparkyFitnessServer/backup
Default
/mnt/user/appdata/sparkyfitness/backup
Value
/mnt/user/appdata/sparkyfitness/backup
Uploads StoragePath

Path to the uploads storage folder

Target
/app/SparkyFitnessServer/uploads
Default
/mnt/user/appdata/sparkyfitness/uploads
Value
/mnt/user/appdata/sparkyfitness/uploads
Log LevelVariable

Logging level

Target
SPARKY_FITNESS_LOG_LEVEL
Default
INFO|DEBUG|WARN|ERROR
Node EnvironmentVariable

Node environment setting

Target
NODE_ENV
Default
production|development
Internal API PortVariable

Internal ort for API communication. Not recommended to change.

Target
SPARKY_FITNESS_SERVER_PORT
Default
3010
Value
3010

Download Statistics

570,094
Total Downloads
141,701
This Month
78,228
Avg / Month

Total Downloads Over Time

Loading chart...

Details

Repository
codewithcj/sparkyfitness_server:latest
Last Updated2026-05-24
First Seen2025-08-29

Run SparkyFitness---Backend on Unraid.

SparkyFitness---Backend is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.