Repository navigation
Dreeve
Dreeve (formerly Statistics for Strava) is a self-hosted dashboard for your sports data. VeloPopuli can send every ride's .FIT file straight to your own instance.
-
In Dreeve's admin panel open Settings → Security → API access and generate a key (it looks like
drv_…). -
Set it as
DREEVE_API_KEYin Dreeve's.envand recreate the containers. Dreeve must run withIMPORT_MODE=files. -
In VeloPopuli → Settings → Dreeve, enter your instance's address and the key and press Save and test. The test tells you if the key is wrong or uploads are switched off.
The address must start with
https://: VeloPopuli refuses plainhttp://so your key isn't sent unencrypted. Onlylocalhostand127.0.0.1are allowed without it. If your Dreeve runs on your home network over plain http, put a reverse proxy with a certificate in front of it.
Then:
- Rides upload with one click on the summary or history screen, or automatically (toggle on the Dreeve card).
- Dreeve queues the file and imports it within a few minutes; the button shows what the server said. There is no page to open, so look in Dreeve's activity list.
- Dreeve reads everything from the FIT file (power, heart rate, cadence, the route), so nothing else is sent.
- Your Dreeve rides with a GPS track can be raced as ghosts: From Dreeve… when setting up a ride.
- Ride one of them again as a route: Import from Dreeve… on the routes page lists your rides, searchable by name or date and filtered by bike and distance. This needs Dreeve 5.4 or later, which exports a ride as GPX.
The key is kept in the system keychain (macOS, Windows) or a file only you can read (Linux).
Getting going
Using the app
- Routes and the map
- Riding
- Workouts
- Virtual gears
- Progress and goals
- Strava
- Dreeve
- Group rides and self-hosting
- Fan and lights
Help
For developers