Skip to content

FAQ & Troubleshooting

Common questions and solutions for Stridevox.

General

What data does Stridevox access from my Garmin account?

Stridevox reads your activities (runs, rides, swims, etc.), sleep data (stages, duration), and daily summaries (steps, calories, Body Battery, stress). It does not access personal information like your name, address, or payment details.

Is my data sent to third parties?

Your fitness data is sent to the AI provider you've configured (xAI, OpenAI, Anthropic, Google, or Azure) as part of chat conversations. It is not shared with anyone else. Your Garmin credentials and AI API keys are encrypted and stored locally on your server.

Can I use Stridevox without a Garmin account?

Stridevox is designed around Garmin Connect integration. Without a Garmin account, the Dashboard, Activities, Charts, and Personal Records won't have data. The Chat feature would work but wouldn't have fitness context to analyze.

What languages does Stridevox support?

The interface is available in English, French, and Spanish. The AI chat can respond in any language supported by your AI provider — just set the chat language or ask in your preferred language.

Connection Issues

I can't connect to Garmin — what should I do?
  1. Check your credentials — Make sure the email matches your Garmin Connect account
  2. MFA code expired — Garmin MFA codes expire in ~60 seconds. Click Connect again for a new code
  3. Garmin rate limiting — If you've made too many attempts, wait 2–3 minutes
  4. Garmin outage — Check connect.garmin.com to see if Garmin is down
My data isn't showing up after sync
  • Check the cache status in Settings to verify data was actually synced
  • Make sure your Activity Limit is high enough to include the activities you expect
  • Try a Full Refresh to rebuild the cache from scratch
  • Check Background Jobs for any failed sync jobs
The sync is taking very long

Large initial syncs (hundreds of activities) can take several minutes. Use Queue Full Refresh to run it as a background job so you can continue using the app. The progress indicator shows how far along it is.

AI Chat

The AI doesn't know about my recent workout

The AI uses cached data. If you just finished a workout:

  1. Wait for it to sync to Garmin Connect (check the Garmin app)
  2. Click Sync Data (Fast) in Settings
  3. Go back to Chat and ask again
The AI gives wrong information about my data
  • Make sure your data is synced and up to date
  • Try starting a new chat session (long sessions accumulate context that may confuse the AI)
  • Try a different AI model or provider for comparison
  • Check if the issue is specific to one workout (it may have incomplete Garmin data)
Can I change the AI provider mid-conversation?

Yes. Changing the provider in Settings takes effect immediately for new messages. Your existing chat history is preserved.

How do I reduce AI API costs?
  • Start new chat sessions for unrelated topics (less context = fewer tokens)
  • Use faster/cheaper models (e.g., Gemini Flash, GPT-3.5) for simple questions
  • Save detailed models for in-depth analysis

Activities

Why don't some activities have a map?

Maps require GPS data. Indoor activities (treadmill runs, indoor cycling) and some manually-created activities don't have GPS tracks, so no map is shown.

How does activity comparison work?

Select 2–5 activities using the Compare mode, then click Compare Now. The comparison table shows key metrics side-by-side with the best values highlighted. Best results are color-coded for easy identification.

Can I share an activity with a non-Stridevox user?

Yes! Shared activity links are public pages that anyone can view in a browser without an account. You can optionally add a password and expiration date.

Personal Records

Why aren't my personal records showing?
  • Records are calculated from your cached activities. Make sure you've synced your data
  • Click Recalculate on the Personal Records page to force a refresh
  • Only certain activity types qualify for records (running, cycling, etc.)
A record seems wrong — how do I fix it?

Click Recalculate to rebuild records from your current cached data. If the underlying Garmin data is incorrect, the record will reflect that.

Security

I lost my authenticator app — how do I log in?
  1. Use one of your backup codes (if you saved them during 2FA setup)
  2. If you have no backup codes, ask an administrator to reset your MFA from the Admin Panel
  3. After MFA reset, you can log in with just your password and optionally re-enable 2FA
I forgot my password
  • If you have an email set: Click Forgot Password on the login screen and check your email for a reset link
  • If you don't have an email set: Ask an administrator to reset your password from the Admin Panel
Can multiple people use Stridevox?

Yes! The first user is the admin and can create additional accounts from the Admin Panel. Each user connects their own Garmin account and has their own chat history, settings, and data.

Technical

What database does Stridevox use?

Stridevox supports both SQLite (default, no setup needed) and PostgreSQL (for production/multi-worker setups). SQLite is recommended for single-user or small-team deployments.

Can I run Stridevox on a Raspberry Pi?

Stridevox is lightweight enough to run on a Raspberry Pi 4 or newer. Use SQLite for the database and a lighter AI model for best performance.

How do I update Stridevox?

Pull the latest code and restart: 

cd stridevox
git pull origin master
cd backend
pip install -r requirements.txt
sudo systemctl restart stridevox

For the frontend, copy updated files to your web server's document root.

Where are my backups stored?

Backups are stored in the backups/ directory inside the backend folder. You can also download them from Settings for offline storage.