Upgrading
Please upgrade: the 1.0.0 web image loaded Contentsquare session analytics on self-hosted instances. 1.1.0 sends nothing to any third party unless you configure it.
- Migrations run automatically when the API starts (AI settings and usage, plans). Back up your database first:
docker compose exec -T postgres pg_dump -U openathlete -Fc openathlete > backup.dump. - New
docker-compose.yml. It now runs the published images instead of building from source. Replace yours with the new one (orgit pullin your clone) and keep your.envand Docker volumes. To keep building from source:docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build. - The app now reaches the API under
APP_URL/api. RemoveAPI_PUBLIC_URLandCORS_ORIGINSfrom.env; onlyAPP_URLis needed. - The API port is now published on localhost only. A reverse proxy on the same host keeps working. If browsers reached the API directly on port 3000, either remove
API_PUBLIC_URL(recommended), or setAPI_PORT=3000to publish it as before. - PostgreSQL (5433) and Redis (6379) are no longer published on the host. Use
docker compose execfor backups and maintenance. - Keep
POSTGRES_PASSWORDempty in an existing.env: your database was created with the former default password. - Device callback URLs now default to
APP_URL/auth/callback/<provider>. The former defaults pointed to routes that do not exist, so Strava and Polar could not connect without overriding them. - Billing only:
STRIPE_PRICE_IDSis replaced bySTRIPE_PRICE_SUPPORTER_MONTHLYandSTRIPE_PRICE_SUPPORTER_YEARLY.
Full guide: https://docs.openathlete.org/docs/getting-started/self-hosting
Highlights
Self-hosting in one command
curl -fsSL https://raw.githubusercontent.com/openathleteorg/openathlete/main/scripts/install.sh | shThe script downloads the configuration, generates the secrets and starts OpenAthlete from the published images. Add -s -- --domain your.domain for HTTPS with automatic certificates (Caddy). Run it again to update. The API image is 600 MB smaller.
Bring your own AI. Every user can connect a key from OpenAI, Anthropic, Google, Mistral, OpenRouter or 200+ other providers, or a local model (Ollama, LM Studio), and pick the model of each feature. Instance keys remain optional, with a monthly budget per user.
Import activities from files. FIT and GPX files can be imported manually, with laps, sensors and GPS gaps handled correctly.
Your data. Download all your data from Settings, and analytics now require consent on the hosted instance.
And more: heart-rate zones from max or reserve heart rate, device temperature from FIT files, records kept across GPS gaps, login errors explained, a password toggle, coaches reaching athletes from the collapsed sidebar, and many fixes.
What's Changed
- feat(web): add mobile web navigation by @antonalvarezbc in #41
- feat(i18n): add Spanish language support by @antonalvarezbc in #40
- feat(web): make the web app installable (PWA) by @antonalvarezbc in #42
- fix(web): keep the chat bubble below dialogs by @antonalvarezbc in #48
- fix(api): honor feedback opt-out in AI analysis by @antonalvarezbc in #49
- fix(web): show sign-up errors by @antonalvarezbc in #50
- fix(api): let coaches read activity training loads by @antonalvarezbc in #51
- feat(api): read device temperature from FIT files by @antonalvarezbc in #44
- fix: keep GPS gaps aligned with time by @antonalvarezbc in #43
- feat: import FIT activities manually by @antonalvarezbc in #45
- feat: import GPX activities manually by @antonalvarezbc in #46
- feat: calculate HR zones from max or reserve by @antonalvarezbc in #47
- fix(ai): stop listing every sport for each zone by @antonalvarezbc in #57
- fix(web): reach athletes from collapsed sidebar by @antonalvarezbc in #58
- fix(web): show login errors by @antonalvarezbc in #55
- feat(web): add a password toggle to login by @antonalvarezbc in #56
New Contributors
- @antonalvarezbc made their first contribution in #41
Full Changelog: v1.0.0...v1.1.0