Homelab/Docker
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
5adcad42b6e29bc930501e956eb517f45d056e76
Docker/garmin-grafana/README.md

2.6 KiB
Raw Blame History

Garmin-Grafana

This directory contains the configuration for a set of services that fetches data from Garmin Connect, stores it in InfluxDB, and visualizes it with Grafana.

Services

  • garmin-fetch-data: A service that fetches data from Garmin Connect.
  • influxdb: An InfluxDB database for storing Garmin Connect data.
  • grafana: A Grafana instance for visualizing the data.

How to start

  1. Create a .env file based on the .env.example file.

  2. Set the GARMINCONNECT_EMAIL and GARMINCONNECT_PASSWORD (Base64 encoded) variables in the .env file.

  3. If you have 2FA enabled: You must authenticate manually once to generate the session tokens.

    docker-compose run --rm garmin-fetch-data

    Enter your 2FA code when prompted. The tokens will be saved to the ./garminconnect_tokens folder.

    Server Console (Komodo/Portainer) - Robust Method: The fetcher requires a database connection to start. Use the provided server-token-setup.yaml file.

    1. Copy server-token-setup.yaml to your server.
    2. Run: 
      docker-compose -f server-token-setup.yaml run --rm setup-fetcher

    The script will interactively prompt you for your Garmin Email, Password (Plain Text), and 2FA Code. The tokens will be generated in /opt/docker/garmin-grafana/tokens (as defined in the yaml).

    Finally, in Komodo/Portainer, set the environment variable GARMINCONNECT_TOKENS=/opt/docker/garmin-grafana/tokens.

  4. Run docker-compose up -d to start the application.

Setup & Access

After starting the application, you can access the Grafana web interface at http://localhost:3000.

  • User: admin
  • Password: admin

Configure a new data source for InfluxDB (URL: http://influxdb:8086, Database: GarminStats) and import the dashboards.

Historical Data Download (Bulk Import)

To download old history, use the MANUAL_START_DATE variable. This will fetch data in reverse chronological order from the current date (or MANUAL_END_DATE) back to the start date.

docker-compose run --rm -e MANUAL_START_DATE=YYYY-MM-DD garmin-fetch-data

Options:

  • MANUAL_END_DATE=YYYY-MM-DD: Optional end date (defaults to today).
  • FETCH_SELECTION=...: Limit what data is fetched (e.g., activity,sleep).

Note: Garmin archives intraday data older than 6 months, so very old detailed data (HR, sleep stages) might be missing unless manually refreshed in the Garmin Connect app.