FitMop/docs/garmin_login.md

21 lines
757 B
Markdown

# 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:
```env
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.