FitMop/docs/garmin_login.md

757 B

Garmin Connect Login Setup

To sync your fitness data from Garmin Connect, you need to provide your credentials.

Credentials Configuration

Create a .env file in the backend/ directory with the following content:

GARMIN_EMAIL=your_email@example.com
GARMIN_PASSWORD=your_password

[!IMPORTANT] If you have Multi-Factor Authentication (MFA) enabled on your Garmin account, the integration will prompt you for the code during the first run. The session will be saved locally in backend/.garth to avoid repeated logins.

Security Note

  • The .env file is included in .gitignore and will never be committed.
  • Your credentials are only used locally to authenticate with Garmin's official login service via the garth library.