talus is a self-hosted endurance telemetry backup and training analytics engine designed for trail and road running, gravel cycling, and mountain biking.
It runs continuously as a lightweight service on your home server, incrementally synchronizing second-by-second activity telemetry from Strava, tracking edits and crops, and serving an interactive web dashboard with volume rollups and physiological progress analytics (Aerobic Efficiency Factor, Decoupling, and Route Progression).
- Go to strava.com/settings/api and create an API application.
- Set the Authorization Callback Domain to
localhost. - Note your Client ID and Client Secret.
# Standard unified volume:
docker run -d \
--name talus \
--restart unless-stopped \
-p 8080:8080 \
-v ~/talus-data:/data \
talus
# Or separate data directory from metadata and OAuth tokens:
docker run -d \
--name talus \
--restart unless-stopped \
-p 8080:8080 \
-v /mnt/fast-storage/talus-config:/config \
-v /mnt/bulk-storage/talus-data:/data \
-e CONFIG_DIR=/config \
-e DATA_DIR=/data \
talusservices:
talus:
image: talus:latest
container_name: talus
restart: unless-stopped
ports:
- "8080:8080"
volumes:
- /mnt/storage/activities:/data # Raw JSON activity data
- ~/.config/talus:/config # OAuth credentials & sync metadata
environment:
- PORT=8080
- DATA_DIR=/data
- CONFIG_DIR=/config
- SYNC_INTERVAL=1h # Hourly incremental backup
- CHECK_UPDATES_INTERVAL=24h # Daily scan for title edits, crops, gear changes- Open
http://<your-server-ip>:8080in your browser. - If this is a fresh setup, Talus will automatically show the Connect with Strava setup page.
- Enter your Client ID and Client Secret and click Connect.
- Once authorized, Talus saves
.talus-config.jsoninto your persistent directory, begins the initial sync in the background, and loads your dashboard.
You can also run Talus directly without Docker:
# Run web dashboard & background daemon (unified directory):
go run . /path/to/data
# Run web dashboard with separated data, config (OAuth tokens), and metadata directories:
go run . --data-dir /path/to/activities --config-dir /path/to/config --metadata-dir /path/to/metadata
# Run a one-off headless sync (prompts for setup if unconfigured):
go run . sync /path/to/data
# Headless sync with separate data and config directories:
go run . sync --data-dir /path/to/activities --config-dir /path/to/config
# Scan recent activities for Strava edits / title changes / crops:
go run . sync /path/to/data --recent 30d
# Force re-download all activities:
go run . sync /path/to/data --force| Variable | Default | Description |
|---|---|---|
PORT |
8080 |
HTTP port for the web dashboard and API. |
SYNC_INTERVAL |
1h |
Interval between incremental sync checks for new activities. |
CHECK_UPDATES_INTERVAL |
24h |
Interval between scans detecting Strava edits, crops, and gear changes. |
DATA_DIR |
/data |
Path to directory where raw activity JSON files (activities/) are stored. |
CONFIG_DIR |
$DATA_DIR |
Path to directory where OAuth credentials and tokens (.talus-config.json) are stored. |
METADATA_DIR |
$CONFIG_DIR |
Path to directory where sync metadata (metadata.json) is stored. |
STRAVA_CLIENT_ID |
"" |
Optional: prefill Client ID in setup page. |
STRAVA_CLIENT_SECRET |
"" |
Optional: prefill Client Secret in setup page. |
- Period Rollups: Weekly, Monthly, and Yearly aggregation.
- Sport Breakdown: Filter by Running, Trail, Road, Rides (Gravel/MTB), Hikes, or All Activities.
- Visual Charts: Bar chart of distance with stacked Road vs. Trail splits and elevation gain line overlay.
- Pace & GAP: Trend lines comparing flat pace with Grade-Adjusted Pace.
- Units: Toggle dynamically between Metric (
km,m) and Imperial (mi,ft).
-
Cardiovascular Efficiency Factor (EF): Tracks meters moved per heartbeat (
Speed / Avg HR). Scatter plot with a 5-run rolling average trendline to identify aerobic conditioning gains. -
Aerobic Decoupling (
$Pa:Hr$ ): Evaluates cardiac drift between the 1st half and 2nd half of steady-state runs (target$< 5%$ ). - Repeated Route Progressions: Automatically clusters activities matching the same GPS route and tracks date-by-date pace, HR, and efficiency improvements over identical terrain.