Garmin-Grafana is a Docker container that fetches health data from Garmin devices and stores it in InfluxDB for visualization with Grafana.
The tool solves the problem of accessing and visualizing long-term health trends from Garmin wearables. It works by automatically pulling data from Garmin servers on a scheduled basis, storing the metrics in a local InfluxDB database, and providing pre-built Grafana dashboards for analysis. The approach eliminates manual data export and enables continuous monitoring of health metrics over time.
The project suits users who own Garmin smartwatches or fitness trackers and want to build a personal health analytics system without relying on Garmin's native interface. It works well for those comfortable with Docker and self-hosted infrastructure. The tool offers multiple installation paths: an automated helper script for less technical users, manual Docker setup for those familiar with Linux, a Synology-specific guide, and Kubernetes deployment via Helm charts. The project includes dashboards for general health metrics and a separate strength training dashboard covering exercise progression, training volume, and personal records. It supports historical data fetching for backfilling old data, importing from Garmin Connect export files, multi-user setups for household accounts, and CSV export for further analysis. A sister project exists for Fitbit users with similar functionality.
The project maintains active development with regular updates to accommodate changes in Garmin's API and user-reported issues. The codebase includes comprehensive documentation covering troubleshooting, backup procedures, and upgrade paths. The maintainer actively engages with users through discussions and provides supplementary resources including a desktop application option and contribution guidelines for community involvement.
