DuarteSantos8/openGym

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/DuarteSantos8/openGym.svg?style=card)](https://bestofgithub.dev/repo/DuarteSantos8/openGym)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/DuarteSantos8/openGym.svg)](https://bestofgithub.dev/repo/DuarteSantos8/openGym)

Loading README…

Variable	What it does	Default
`RP_ID`	Hostname passkeys are bound to	`localhost`
`ORIGIN`	Full URL the app is served from	`http://localhost:8080`
`WEB_PORT`	Host port for the web UI	`8080`
`NGINX_PORT`	Port the web container listens on inside the container	`80`
`BACKEND`	Name of the API service that `/api` is proxied to	`api`
`PORT`	Port the API listens on; the web container proxies to the same value	`3000`
`RP_NAME`	Name shown in the passkey prompt	`openGym`
`SESSION_DAYS`	How long a sign-in lasts, in days	`90`
`ADMIN_UIDS`	User ids that get the admin dashboard, comma-separated	(none)
`FIRST_USER_ADMIN`	`1`: the first profile created on an empty instance becomes its admin	(off)
`INVITE_ONLY`	Require an invite code to create a profile	(off)
`ALLOW_GUEST`	Offer "Continue without account"; `0` requires a profile	(on)
`PASSWORD_LOGIN`	Offer name-and-password sign-in next to passkeys	(off)
`TRUST_PROXY`	Let the sign-in throttle read the client address from proxy headers	`1` in `docker-compose.yml`
`AUDIT_LOG`	Record sign-ins and admin actions; `0` records nothing	(on)
`AUDIT_MAX`	Events kept in the activity log; `0` for no limit	`5000`
`AUDIT_DAYS`	Days kept in the activity log; `0` keeps until `AUDIT_MAX`	`90`
`AUDIT_IP`	Record the caller's address: `off`, `net` (network only) or `full`	`off`
`ALLOWED_PRIVATE_IPS`	Private addresses push endpoints may resolve to (FakeDNS, split-horizon DNS): comma-separated IPs, `a-b` ranges or CIDR blocks	(none)
`VAPID_SUBJECT`	Contact URL sent with push notifications	your `ORIGIN`
`API_TARGET`	API image to build: `default`, or `coach` with the Claude Agent SDK and Codex CLI	`default`
`COACH_DISABLED`	`1` forces the AI coach off instance-wide	(unset)

	Get it
iPhone and iPad, with the Apple Watch app	The App Store, in every App Store country
Android	The signed APK from the latest release or opengym.ch, in three sizes: Standard (`openGym-X.Y.Z.apk`, animations at 180 px, about 315 MB), Plus (`openGym-Plus-X.Y.Z.apk`, 240 px, about 424 MB) and HD (`openGym-HD-X.Y.Z.apk`, 360 px, about 760 MB). It updates itself and stays the kind you picked
Google Play	Coming: a new developer account has to run a closed test first

File	Contents
`db.json`	Profiles and public passkey data
`db.json.bak`	A copy of the last good `db.json`, used if the main file can't be read
`state-<user>.json`	Each user's plan, workouts, body weight and settings
`audit.log`	Admin activity log (no IP addresses unless you turn that on)
`secret`	Session-cookie signing key

I want to	Read
Get a quick answer	FAQ
Set up my own instance	Self-hosting
Use the Android or iPhone app	Phone app
Bring my history from another app	Importing data
Turn on the AI coach	AI coach
Contribute code	Contributing
Report a security problem	Security

Release	When	Theme
v1.4.0	released Oct 2026	A new exercise database with 5,632 exercises, plus two rounds of community work
v1.4.1	released Oct 2026	Bug fixes for v1.4.0
v1.4.2	released Oct 2026	The App Store, the Apple Watch, widgets, three APK sizes
v1.4.3	released Oct 2026	The Halloween and community release: gym reminder, health data read back, watch upgrades, CSV export
v1.4.4	Nov 2026	Programmes, a tour with tutorials, AirPods heart rate, kg or lb per exercise, bug fixes
v1.4.5	Nov 2026	Google Play, F-Droid, Settings → Integrations (Strava, webhooks, calendar, Nextcloud), timed holds that start themselves
v1.4.6	Dec 2026	Wear OS, deeper Health Connect, body composition
v1.4.7	Dec 2026	The progression engine by @giulioleuci, circuits, AMRAP and EMOM
later	dates are guesses	Search and catalogue, accounts, a trainer role, skins, Garmin, database storage

DuarteSantos8/openGym

Why openGym

Features

Quick start

Phone app

How it works

How sync works

Your data

Documentation

Roadmap

Community

Where the code lives

How openGym is built

Support

License