Skip to content

Connecting Garmin

Stridevox pulls your fitness data directly from Garmin Connect — the same service your Garmin watch syncs to. This page explains how to connect, sync, and manage your Garmin data.

Linking Your Account

  1. Go to Settings (click the icon)
  2. Scroll to the Garmin Connect section
  3. Enter the email associated with your Garmin Connect account
  4. Click Connect to Garmin

Garmin MFA (Multi-Factor Authentication)

If your Garmin account has MFA enabled, you'll be prompted for a verification code:

  1. Check your email or authenticator app for the 6-digit code
  2. Enter it in the MFA field that appears
  3. Click Submit MFA Code

MFA codes expire quickly

Garmin MFA codes are valid for about 60 seconds. If it expires, click Connect to Garmin again to request a new code.

Your credentials are encrypted

Stridevox encrypts your Garmin email and password using Fernet encryption before storing them in the database. They are never stored or transmitted in plain text.

Syncing Your Data

Once connected, Stridevox can pull three types of data from Garmin:

Data Type What It Includes
Activities Runs, rides, swims, walks — with GPS routes, heart rate, pace, etc.
Sleep Sleep stages (deep, light, REM, awake), duration, quality scores
Daily Summaries Steps, calories, distance, Body Battery, stress levels

Sync Options

In the Data Management section of Settings, you have several sync options:

Button What It Does
Sync Data (Fast) Incremental sync — fetches only new data since last sync. Quick and efficient.
Full Refresh Clears the cache and re-fetches everything from Garmin. Takes longer.
Clear Cache Deletes all cached data without re-fetching.
Queue Full Refresh Runs a full refresh as a background job — the page stays responsive.
Queue Incremental Runs an incremental sync as a background job.

Recommended sync workflow

Use Sync Data (Fast) for regular updates (e.g., daily). Use Queue Full Refresh for the initial import or if you want to reset everything.

Sync Settings

You can control how much data Stridevox pulls:

  • Activity Limit — Maximum number of activities to cache (default: 100, max: 10,000)
  • Days Range — How many days of daily summaries and sleep data to keep (default: 30, max: 365)

To check how many activities you have in Garmin, click Check Total Activities in Garmin. You can then click Use This Number to set the activity limit automatically.

Background Jobs

Sync operations can run as background jobs, which is useful for large imports:

  • Status indicators: Pending, Running, Completed, Failed
  • Progress: Shows percentage complete for running jobs
  • Actions: Cancel running jobs or Retry failed ones
  • Click Refresh to update the job list

Cache Status

The Data Management section shows your current cache status:

  • Number of cached activities
  • Amount of sleep data stored
  • Number of daily summaries
  • Last sync timestamp

Keeping Data Fresh

Stridevox doesn't auto-sync in the background. To keep your data up to date:

  1. Click Sync Data (Fast) after your workouts sync to Garmin
  2. Or schedule a Queue Incremental background job

The Dashboard will update automatically after each sync to show your latest stats.