Skip to content

openRun 0.1.0

Choose a tag to compare

View all tags
@stretch0 stretch0 released this 30 Oct 11:41
· 25 commits to main since this release
v0.1.0
733a6fd
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

The first release of openRun: a self-hosted running app for you and your run club. Your runs stay private unless you choose to share them.

What's in it

Accounts and setup

  • One Docker image with SQLite; database updates apply on start
  • Passkeys or email and password; the first account becomes the admin; optional invite-only sign-up
  • Installable PWA that works offline from its cache

Run log

  • Import FIT and GPX files (several at once, gzipped too) or add runs by hand; original files are kept
  • Maps, splits, laps, pace, heart rate and elevation charts
  • Best efforts and PBs, weekly and monthly totals, a year heatmap, race predictions, shoe mileage
  • Export everything as JSON or CSV

Privacy

  • Runs are private by default; you choose what each club sees
  • Privacy zones trim shared maps near home or work
  • No admin password resets or impersonation; a "who can see what" page

Run clubs

  • Repeating and one-off runs, meeting points, RSVPs, weather forecasts
  • Coffee after the run: a café menu, orders with a saved usual, and an order list to show at the counter
  • Push reminders and change notices, per-club mute
  • Share a run with a club as a copy, and take it back any time
  • Attendance highlights (streaks, milestones, runs in the rain), never speed rankings
  • Owners can hand a club to another member

Watch sync

  • Runs from Garmin, Coros, Polar, Suunto and Wahoo arrive through intervals.icu every 30 minutes, as the original files
  • Backfill from a chosen date; duplicates and deleted runs are skipped

Install

curl -O https://raw.githubusercontent.com/stretch0/openRun/main/docker-compose.yml
curl -o .env https://raw.githubusercontent.com/stretch0/openRun/main/.env.example

Set BETTER_AUTH_SECRET and ORIGIN in .env, then docker compose up -d. To stay on this release line, use ghcr.io/stretch0/openrun:0.1 in docker-compose.yml. The README covers HTTPS, upgrades and backups.

Not in this release

Training plans and an MCP server were dropped from v0.1, because Garmin MCP servers already build plans and put workouts on your watch. See ROADMAP.md for what's next.

Assets 4
Loading