# Deploy SparkyFitness with Easypanel

URL: /templates/sparkyfitness

SparkyFitness is a self-hosted, privacy-first alternative to MyFitnessPal. Track nutrition, exercise, hydration, and body metrics while keeping full control of your data. Built for families with AI-powered features, SparkyFitness offers comprehensive health tracking with integrations for Apple Health, Google Health Connect, Fitbit, Garmin Connect, and Withings. Features include goal setting, interactive charts, long-term reports, and optional AI chatbot for conversational data logging.

## Benefits

### Privacy-First Health Tracking

Keep complete control of your health data with self-hosted deployment. No third-party services have access to your sensitive health information.

### Family-Friendly Platform

Built for families with multiple user profiles and shared access features, making it easy to track health together.

### Comprehensive Health Integration

Sync data from Apple Health, Google Health Connect, Fitbit, Garmin Connect, and Withings for a complete view of your health metrics.

## Features

### Nutrition & Exercise Tracking

Track food intake, exercise, hydration, and body measurements with interactive charts and long-term reports.

### AI-Powered Features

Optional AI chatbot for conversational data logging, meal logging from images, and progress reviews.

### Goal Setting & Check-ins

Set health goals and perform daily check-ins to stay on track with your fitness journey.

### Light & Dark Themes

Customizable interface with light and dark themes for comfortable viewing at any time of day.

## Configuration

- `appServiceName` (App Service Name, required): sparkyfitness

- `appServiceImage` (App Service Image, required): codewithcj/sparkyfitness:v0.16.5.4

- `serverImage` (Server Image, required): codewithcj/sparkyfitness_server:v0.16.5.4

- `apiEncryptionKey` (API Encryption Key (Auto-generated if empty)): Set during installation — A 64-character hex string for data encryption. Auto-generated if not provided. Changing this will invalidate existing encrypted data.

- `betterAuthSecret` (Better Auth Secret (Auto-generated if empty)): Set during installation — Secret key for Better Auth authentication. Auto-generated if not provided.

- `logLevel` (Log Level): ERROR / WARN / INFO / DEBUG

- `allowPrivateNetworkCors` (Allow Private Network CORS): true — Required for current upstream behavior so EXTRA_TRUSTED_ORIGINS is applied. Disable only if upstream removes this coupling.

- `disableSignup` (Disable Signup): false — Set to true to disable new user registrations

- `forceEmailLogin` (Force Email Login): true — Force email/password login to be enabled. Fail-safe to prevent being locked out if OIDC is misconfigured.

- `adminEmail` (Admin Email (Optional)): Set during installation — Email of a user to automatically grant admin privileges on server startup.

- `extraTrustedOrigins` (Extra Trusted Origins (Optional)): Set during installation — Comma-separated list of additional URLs that Better Auth should trust (e.g., http://192.168.1.175:8080)

- `emailHost` (Email Host (Optional)): Set during installation — SMTP host for email notifications (e.g., smtp.example.com)

- `emailPort` (Email Port (Optional)): Set during installation — SMTP port (e.g., 587)

- `emailSecure` (Email Secure (Optional)): true — Use TLS/SSL for email (true) or plain text (false)

- `emailUser` (Email User (Optional)): Set during installation — SMTP username

- `emailPass` (Email Password (Optional)): Set during installation — SMTP password

- `emailFrom` (Email From (Optional)): Set during installation — Email address to send from (e.g., no-reply@example.com)

- `customDomain` (Custom Domain (Optional)): Set during installation — Custom domain for the application (e.g., app.example.com)

## Services

- sparkyfitness-db: postgres

- sparkyfitness-server: app (codewithcj/sparkyfitness_server:v0.16.5.4)

- sparkyfitness-frontend: app (codewithcj/sparkyfitness:v0.16.5.4)

## Resources

- [Website](https://codewithcj.github.io/SparkyFitness)

- [GitHub](https://github.com/CodeWithCJ/SparkyFitness)

- [Documentation](https://codewithcj.github.io/SparkyFitness)

- [Docker Hub Server](https://hub.docker.com/r/codewithcj/sparkyfitness_server)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/sparkyfitness)