Open-source gym & body-weight tracker, now in the App Store (iPhone + Apple Watch) and as an Android APK. Plan routines, log workouts, see which muscles are trained, import from Strong/Hevy/FitNotes. Self-host it or use it on the phone alone.
JavaScript apple-watchbodyweightdockerfitnessfitness-trackergymhealthiosmcpnodejspasskeysprogressive-web-applicationspwareactself-hostedself-hostingvitewebauthnweightliftingworkout-tracker
Docs: Settings paths for the new pages
Duarte Santosbb94798f85de
diff --git a/docs/AI_COACH.md b/docs/AI_COACH.mdindex a285730b7..20c92ebee 100644--- a/docs/AI_COACH.md+++ b/docs/AI_COACH.md@@ -48,7 +48,7 @@ own (see [On the phone](#on-the-phone)).The card appears only when all of these hold:- **The master switch is on.** That is **Set up the Coach** on the admin card- (**Settings → Admin dashboard**, the **AI Coach** card), and afterwards the toggle at the top+ (**Settings → Account → Admin dashboard**, the **AI Coach** card), and afterwards the toggle at the topof the same card. A provider that is connected and passes **Test the Coach** is not enoughon its own: with the switch off, the server tells every app there is no Coach, and the cardreads *Off right now — nobody sees it anywhere in the app*.@@ -67,7 +67,7 @@ picks it up the next time it is opened or reloaded.**1. Get a key** from the provider's own console. For a compatible endpoint, get the URL itanswers on instead, and a key only if it wants one.-**2. Connect it.** In the app: **Settings → Admin dashboard**, the **AI Coach** card.+**2. Connect it.** In the app: **Settings → Account → Admin dashboard**, the **AI Coach** card.- Toggle the card on.- Pick the provider chip.@@ -147,7 +147,7 @@ Complete its normal browser sign-in and copy the token it prints. openGym neverthat flow — it only ever receives the finished token. (Claude also accepts an Anthropic API keyhere, under the same chip; the setup token is the route for a Claude subscription.)-**3. Connect it.** In the app: **Settings → Admin dashboard**, the **AI Coach** card.+**3. Connect it.** In the app: **Settings → Account → Admin dashboard**, the **AI Coach** card.- Toggle the card on.- Pick the **Claude (Anthropic)** provider chip.@@ -177,7 +177,7 @@ validator rather than trimmed. The card is kept in the Coach's history like ever### Comparing with others on the instance-Off unless the admin turns it on (**Settings → Admin dashboard**, the **AI Coach** card →+Off unless the admin turns it on (**Settings → Account → Admin dashboard**, the **AI Coach** card →**Advanced → Let people compare with each other**), and then still off for each person until theyopt in themselves (**Compare with others here → Include me** in the Coach chat). The trade issymmetric: a profile that does not share sees nothing.@@ -428,7 +428,7 @@ The App-Store build has no server of its own, so the Coach there is a choice mad**Settings → AI Coach**, and until it is made nothing AI-related is loaded at all:- **Use my self-hosted openGym.** Pair the phone with your instance (the same pairing flow as- syncing — **Settings → Pair the mobile app** on the site, then the address and code on the+ syncing — **Settings → Account → Pair the mobile app** on the site, then the address and code on thephone). A paired phone is an ordinary profile: the Coach runs on your server with whateverprovider the admin configured, under the rules above, and nothing on the phone changes.- **Bring my own API key.** The phone calls Anthropic, OpenAI, Gemini or a compatible endpointdiff --git a/docs/DATA_IMPORTS.md b/docs/DATA_IMPORTS.mdindex 18b6f37e2..1108465f6 100644--- a/docs/DATA_IMPORTS.md+++ b/docs/DATA_IMPORTS.md@@ -1,6 +1,6 @@# Importing and exporting data-Everything here lives in the app under **Settings → Data**, except plan sharing, which is on the+Everything here lives in the app under **Settings → Data & backup**, except plan sharing, which is on the**Plan** screen.| You want to | Use |@@ -13,7 +13,7 @@ Everything here lives in the app under **Settings → Data**, except plan sharin## Workout history from another app-Export a CSV from your old app, then pick it under **Settings → Data → Import from another app**.+Export a CSV from your old app, then pick it under **Settings → Data & backup → Import from another app**.openGym matches exercise names against its library; anything it doesn't recognise becomes one ofyour own exercises, so nothing in the file is dropped. Days that already have a workout in openGymare left alone, so importing the same file twice never duplicates anything.@@ -40,7 +40,7 @@ Other files work too, as long as they have a date, an exercise name and somethinWith **Hevy Pro** you can skip the CSV:1. In Hevy, open [Settings → Developer](https://hevy.com/settings?developer) and create an API key.-2. In openGym, go to **Settings → Data → Import from Hevy** and paste the key. It's used for this+2. In openGym, go to **Settings → Data & backup → Import from Hevy** and paste the key. It's used for thisimport only and isn't saved.3. Choose workouts, routines, weigh-ins or any mix, then confirm.@@ -80,7 +80,7 @@ library.- **Import backup** restores such a file and *replaces* everything currently in the app.- **Auto-backup on changes** (phone app only) saves a dated copy to `Documents/openGym` after eachworkout or routine edit and keeps the newest 14. Point a sync app at that folder to get them off- the phone — or, on Android, choose the sync app's own folder under Settings → **Backup folder**.+ the phone — or, on Android, choose the sync app's own folder under Settings → Data & backup → **Backup folder**.If you host openGym yourself, backing up the `./data` folder covers every profile at once; see[backups](SELF_HOSTING.md#6-backups).diff --git a/docs/FAQ.md b/docs/FAQ.mdindex 052312492..e68a3b388 100644--- a/docs/FAQ.md+++ b/docs/FAQ.md@@ -36,7 +36,7 @@ checks for updates itself. Get it from theOn a self-hosted instance, in the `./data` folder next to `docker-compose.yml`: one JSON file perprofile plus the account list. Back up that folder and you've backed up everything. In the phone appit's in the app's private storage. In guest mode it's only in that browser. You can export-everything as one file at any time under **Settings → Data**.+everything as one file at any time under **Settings → Data & backup**.### Does the app send anything anywhere?diff --git a/docs/MOBILE.md b/docs/MOBILE.mdindex 5e559f1bc..c62c193e6 100644--- a/docs/MOBILE.md+++ b/docs/MOBILE.md@@ -34,9 +34,9 @@ same app, not a different build or download.Passkeys can't be used for this: the app's WebView runs at its own origin, which nevermatches the real hostname WebAuthn needs. Instead you *pair* the device from a browser-that's already signed in: Settings → **"Pair the mobile app"** shows a one-time code (valid+that's already signed in: Settings → Account → **"Pair the mobile app"** shows a one-time code (valid5 minutes); enter your server's address and that code in the app (same first-launch screen,-or Settings → **"Connect to my server"** later) to finish. Notes:+or Settings → Account → **"Connect to my server"** later) to finish. Notes:- Works offline too: the phone keeps its copy (and the file mirror) while connected, andchanges made without a network go to the server as soon as it is reachable again.@@ -55,7 +55,7 @@ or Settings → **"Connect to my server"** later) to finish. Notes:of a cookie. The phone has no passkey to sign back in with, so it has to be **pairedagain**; nothing on it is lost meanwhile (see below). See `/api/pair/create` and`/api/pair/redeem` in `api/server.js` for the exchange itself.-- Settings → "Disconnect" first checks that your server has every change. If it has, the+- Settings → Account → "Disconnect" first checks that your server has every change. If it has, thephone drops cleanly back to local mode. If not, it says how many changes are missing andoffers **Try again**, **Export backup**, or **Disconnect anyway** — which keeps thosechanges on the phone and adds them back the next time it is paired with the same server@@ -63,7 +63,7 @@ or Settings → **"Connect to my server"** later) to finish. Notes:### Connection states-Settings → **Server & sync** shows the server, the account, how things stand, when the phone+Settings → Account → **Server & sync** shows the server, the account, how things stand, when the phonelast held exactly what the server holds, how many changes are still waiting, and a **Syncnow** button that says how it went. Whenever the app is *not* connected, a line under thestatus bar says so on every screen, and stays until the condition is gone:@@ -77,11 +77,11 @@ status bar says so on every screen, and stays until the condition is gone:| *This phone is no longer paired with your server…* | A phone that an earlier version of the app unpaired by itself after its token was refused. The address is gone. | **Pair again**, typing the address. || *On this phone only, not connected to a server* | Local mode, chosen at first launch or after Disconnect. Said quietly. | Nothing, or **Connect** to pair with a server. |-Don't want the line? Settings → Appearance → **Show connection status** turns it off (it is on+Don't want the line? Settings → Look & Home → **Show connection status** turns it off (it is onby default, and the setting travels with your profile). A phone kept local on purpose then showsnothing at all. On a phone with a server, a problem — offline, an error, a refused phone, orchanges still waiting after a few seconds — puts a small orange dot on the **Home** tab and on-the Settings gear instead; Settings → Server & sync says what it is.+the Settings gear instead; Settings → Account → Server & sync says what it is.In every one of these states the phone keeps its data and every change you make. Pairingagain with the **same account** merges what the phone kept with what the server has — new@@ -97,15 +97,15 @@ Where the phone keeps things, in case you ever need them by hand:belongs to: a paired phone only ever takes the file back for that account.- `opengym-stash.json`, same directory — changes kept by "Disconnect anyway" or by anotheraccount pairing, waiting for their server and account.-- `Documents/openGym/opengym-backup-YYYY-MM-DD.json` — only with Settings → **Auto-backup on+- `Documents/openGym/opengym-backup-YYYY-MM-DD.json` — only with Settings → Data & backup → **Auto-backup onchanges** switched on: a dated copy after every finished workout or edited routine, in afolder of its own under the phone's Documents folder, where a file manager or a sync app(Syncthing, a cloud folder) can reach it without taking the rest of Documents along. Onefile per day; each new copy deletes all but the newest 14 of these dated files in thatfolder. Nothing else is deleted, in that folder or anywhere: other files you keep there, andthe copies versions before 1.3.9 wrote straight into `Documents/`, stay until you remove- them yourself. Settings → **Import backup** reads any of them back, wherever it is.- On Android, Settings → **Backup folder** (under Auto-backup) picks another folder with the+ them yourself. Settings → Data & backup → **Import backup** reads any of them back, wherever it is.+ On Android, Settings → Data & backup → **Backup folder** (under Auto-backup) picks another folder with thesystem folder picker — a sync app's folder, an SD card — and the copies go there instead,pruned to the same 14. The choice belongs to this phone and does not sync. If the folderstops accepting copies (the permission revoked, the folder deleted), they go to@@ -126,12 +126,12 @@ never stored.`index.json`. The state keeps only a reference of a few hundred bytes. A MOV is stored withan `.mp4` name so the WebView plays it.- **Local mode:** that folder is the only copy. **Export with photos & videos (.zip)** in- Settings → Data writes a zip with the usual JSON backup and every file, through the share+ Settings → Data & backup writes a zip with the usual JSON backup and every file, through the sharesheet; **Import backup** takes that zip back. The daily auto-backup stays JSON only.- **Paired with a server:** files go up to the server (`PUT /api/media/{hash}`) and come downwith the phone's token into the same folder, so they show offline too. A file that has notreached the server yet is owed like an unsynced change: **Disconnect** says so and keeps it.- Big files wait for Wi-Fi unless you tap Settings → **Photos & videos**.+ Big files wait for Wi-Fi unless you tap Settings → Data & backup → **Photos & videos**.- **Backups:** Android's cloud backup leaves `opengym-media/` out(`res/xml/backup_rules.xml`, `res/xml/data_extraction_rules.xml`) — Auto Backup drops anapp's whole backup past 25 MB, and a few videos would take the state file down with them. Adiff --git a/docs/SELF_HOSTING.md b/docs/SELF_HOSTING.mdindex 781b8b26e..b4b067156 100644--- a/docs/SELF_HOSTING.md+++ b/docs/SELF_HOSTING.md@@ -63,7 +63,7 @@ turn on **password sign-in**, see [§4](#password-sign-in-optional).)The standalone mobile app (`docs/MOBILE.md`) sidesteps this entirely for its "connect to myserver" mode: instead of a passkey ceremony (impossible from inside its WebView, which neverruns at your real hostname), it pairs by redeeming a short one-time code — minted from-Settings → "Pair the mobile app" in an already signed-in browser tab — for a bearer token+Settings → Account → "Pair the mobile app" in an already signed-in browser tab — for a bearer tokensent as an `Authorization` header rather than a cookie. Two consequences worth knowing ifyou're poking at the API directly:@@ -180,7 +180,7 @@ nobody could generate the first code.For more admins (or on an instance that existed before `FIRST_USER_ADMIN`), copy the id from**Settings → Account → Account ID** (tap it to copy; it is also in `./data/db.json` under`users[].id`) and put it in `ADMIN_UIDS`. The same row is how anyone on your instance tells you-which account is theirs when they need help. Admins get an **Admin dashboard** link in Settings: who's training+which account is theirs when they need help. Admins get an **Admin dashboard** link in Settings → Account: who's trainingright now, each user's workout history and body weight, the ability to disable an account (signedout and locked out everywhere until you re-enable it), and — with `INVITE_ONLY=1` — generating andrevoking invite codes. Existing accounts keep working when you switch invite-only on. Admin access@@ -191,11 +191,11 @@ is gated by your passkey and enforced server-side, so it needs no separate loginAn instance whose people share a language can start everyone in it:```bash-DEFAULT_LANG=pt-BR # any code from Settings → Language: de, es, fr, pt-BR, …+DEFAULT_LANG=pt-BR # any code from Settings → Units & language → Language: de, es, fr, pt-BR, …```The sign-in and create-profile screens open in that language, and so does every profile that-has never picked one in **Settings → Language**. Anyone's own choice there always wins, and+has never picked one in **Settings → Units & language → Language**. Anyone's own choice there always wins, andprofiles that existed before this setting keep the language they have — the app cannot tell anold profile that chose English from one that never looked, so it leaves them alone. Without`DEFAULT_LANG`, a new visitor starts in their browser's language when openGym has it, else@@ -385,7 +385,7 @@ hashes stay in `db.json` and work again if you switch it back on — but while ithat only has a password cannot sign in.The mobile app keeps pairing: someone with a password signs in to the website with it and pairs-from Settings → "Pair the mobile app", as with a passkey.+from Settings → Account → "Pair the mobile app", as with a passkey.## 5. Fitting it into an existing stack@@ -528,7 +528,7 @@ tar czf opengym-backup-$(date +%F).tar.gz data/That archive contains all profiles, passkeys and workout history — and, if the activity log ison, `audit.log` with everyone's sign-in times. Worth knowing before you ship the archive to abackup service you don't run. Restore by unpacking it back into the project folder. (Individual-users can also export their own data as JSON from Settings.)+users can also export their own data as JSON from Settings → Data & backup.)The photos and videos of custom exercises are in `data/uploads/`, and they are most of what makesthe archive large. To leave them out:@@ -540,7 +540,7 @@ tar czf opengym-backup-$(date +%F).tar.gz --exclude=data/uploads data/Restored without them, every profile is intact, and an exercise whose file is gone shows aplaceholder until one of its owner's devices — each keeps its own copy — uploads it again. Whenyou move openGym to another server, copy the whole `data/`, `uploads/` included; each person can-also carry their own through Settings → *Export with photos & videos* and import it there.+also carry their own through Settings → Data & backup → *Export with photos & videos* and import it there.If you enabled the AI Coach with the Codex provider, note what this archive deliberately does**not** contain: `./coach-auth`, where that provider keeps its refreshable sign-in. It is a@@ -557,7 +557,7 @@ in this archive — and unreadable without the secret next to them, like everythopenGym can push two kinds of alert to your phone/desktop, even when the app isn't open:rest-timer-over, and a reminder on days you have a workout planned but haven't logged one yet.-Turn it on per-profile in **Settings → Notifications** (requires a signed-in passkey profile and+Turn it on per-profile in **Settings → Reminders** (requires a signed-in passkey profile andHTTPS — see section 3).No setup needed server-side, and nothing to configure per timezone: VAPID keys are generated on@@ -582,7 +582,7 @@ cannot be scheduled. A reminder that was due while the server was down orrestarting is still sent up to 15 minutes late, once; the browser re-registers its subscriptionwith the server on every signed-in start, so a subscription the server lost heals itself.-**Keep screen awake** (Settings → *During a workout*) has the same transport requirement: the+**Keep screen awake** (Settings → *Workout*) has the same transport requirement: theWake Lock API is only available over HTTPS or on `http://localhost`, so on a plain-LAN-IPinstance the switch shows as unsupported. Nothing to configure server-side either way, and iOSrefuses the lock while the phone is in Low Power Mode.@@ -715,7 +715,7 @@ with (then **Sign out everywhere**). A browser that is still signed in can givepasskey with **Add another device** only if the profile also has a password and`PASSWORD_LOGIN=1`: making the code asks for a passkey or the current password first,because a session on its own may be a stolen cookie. Otherwise there is no self-service recovery: with `PASSWORD_LOGIN=1` an admin can issue a reset code, and without-it the only way back is a backup (**Settings → Export backup (JSON)**, from any device still+it the only way back is a backup (**Settings → Data & backup → Export backup (JSON)**, from any device stillsigned in) imported into a new profile. When you ask your admin for help, the id under**Settings → Account → Account ID** tells them exactly which account is yours. Adding a secondpasskey early is what keeps one lost phone from being a lost profile.@@ -732,8 +732,8 @@ browser (see section 2).| Media didn't download | `docker compose logs media`. Re-run `docker compose up -d`, or run `./scripts/fetch-media.sh`. || Port 8080 already used | Set `WEB_PORT=9090` in `.env` (and update `ORIGIN` for local testing). || A photo or video will not upload ("refused as too large", or it stops partway) | A proxy in front caps the body or cuts the request off: see [Photos and videos](#photos-and-videos-of-custom-exercises) for the body size and timeouts it needs. |-| No "Notifications" option in Settings | Requires a signed-in profile and HTTPS (or `localhost`) — guest mode and plain HTTP over LAN can't subscribe. |-| Day reminder fires at the wrong time | Toggle it off and on in Settings so it re-detects your browser's timezone (also happens automatically on every app load — see section 7). |+| No "Reminders" page in Settings | Requires a signed-in profile and HTTPS (or `localhost`) — guest mode and plain HTTP over LAN can't subscribe. |+| Day reminder fires at the wrong time | Toggle it off and on in Settings → Reminders so it re-detects your browser's timezone (also happens automatically on every app load — see section 7). || Notifications switch is off although I turned it on | The server no longer holds the subscription (rebuilt `data/db.json`, regenerated `vapid.json`); the app re-registers on the next start, or switch it on again. On iOS, push only works from the Home Screen icon. || Want to reset a stuck login | Delete the cookie in your browser; sessions are just signed cookies. || The app says "Your server no longer accepts this phone" (or "this browser") | The server answered 401. Usual causes: "sign out everywhere" was used, the account was disabled, `data/secret` was lost or replaced when the stack was moved (every session and pairing dies with it), or a proxy with its own login rejects requests that carry `Authorization: Bearer`. Nothing on the device is lost: pair the phone again (browser: Settings → "Pair the mobile app"), or sign in again in the browser, and what the device kept is merged into the account. |diff --git a/website/docs.html b/website/docs.htmlindex 40cafc600..3618daccf 100644--- a/website/docs.html+++ b/website/docs.html@@ -231,13 +231,13 @@<li>The <a href="https://github.com/DuarteSantos8/openGym/releases" rel="noopener">GitHub release</a> for that version, with the APK and its <code>.sha256</code> attached.</li></ul><p>Got the file from anywhere else? Verify it against the registry's <code>.sha256</code>- before installing. <b>Updates come to you:</b> when a newer release exists, Settings → Data+ before installing. <b>Updates come to you:</b> when a newer release exists, Settings → About & updatesshows "openGym vX available" — one tap downloads the signed APK, checks its SHA-256against the published checksum and opens the installer (no checksum, no install; the firsttime Android asks for the "install unknown apps" permission). Installing over the oldversion by hand works too — same signing key, data stays. Everything is stored on the phone itself. The app goes online for two things only:exercise images and animations from a CDN, on demand, and — when you open- Settings — a look at the public release list on GitLab to see whether a newer+ Settings → About & updates — a look at the public release list on GitLab to see whether a newerversion exists.</p><p>The app requests notification permission only when you switch the workout-day reminderon, and declares <code>SCHEDULE_EXACT_ALARM</code> so reminders fire to the minute.@@ -269,7 +269,7 @@<li><b>Reschedule any day.</b> Sick, missed a session, fewer gym days this week? Move aworkout to another date without touching the weekly plan itself — the override appliesto that date only.</li>- <li><b>Weeks start where you say.</b> Monday or Sunday, in Settings → General. The+ <li><b>Weeks start where you say.</b> Monday or Sunday, in Settings → Plan & schedule. Theweekly plan, the day strip on Home, the calendar grid and every “this week”total — the workout count, the week streak, the seven-day muscle balance —all follow it. Existing profiles keep the Monday week they have been looking at.</li>@@ -358,7 +358,7 @@name — note, details, progression, bar weight, warm-up set, superset with theprevious or next exercise, swap, move, remove — and the set number is the set's ownmenu (drop set, rest-pause burst, remove). Nothing else sits between you and the numbers.- Miss a button? Settings → During a workout → <b>Workout controls</b> brings any+ Miss a button? Settings → Workout → <b>Fine-tuning</b> brings anygroup back: +/− steppers, drop/burst shortcuts on every row, superset buttons inthe header, move/swap/remove below the card.</li><li><b>List view keeps the header pinned</b> — name, clock, set counter, discard and@@ -379,10 +379,10 @@it. On Android the countdown also sits in a notification, with Pause and ±15 s,and stays on time with the screen off.</li><li><b>Animations are your call:</b> the demo for each exercise can be full size, small, or- hidden entirely during a workout (Settings → During a workout). Hidden collapses+ hidden entirely during a workout (Settings → Workout). Hidden collapsesthe media instead of leaving a gap.</li><li><b>The screen stays awake while you train</b> — on for as long as a workout runs,- released the moment you finish, switchable off in Settings. (Needs HTTPS or+ released the moment you finish, switchable off in Settings → Workout. (Needs HTTPS orlocalhost; iOS refuses the wake lock in Low Power Mode.)</li><li><b>Change your mind mid-session:</b> add an exercise you decided to do, or remove oneyou didn't, without ending the workout. Removing a member of a superset asks which@@ -526,7 +526,7 @@ docker compose up -d # restart alone does NOT re-read .env</code></pre><h3 id="sh-notify">Notifications</h3><p>A self-hosted instance can push two kinds of alert to your phone or desktop, even withthe app closed: <b>rest timer over</b>, and the <b>workout-day reminder</b>. Turn them on- per profile in <b>Settings → Notifications</b> (needs a signed-in profile and HTTPS).+ per profile in <b>Settings → Reminders</b> (needs a signed-in profile and HTTPS).Nothing to configure server-side: VAPID keys are generated on first run and saved to<code>./data/vapid.json</code>, and each browser reports its own timezone. Set<code>VAPID_SUBJECT=mailto:[email protected]</code> if you'd rather push services could@@ -619,7 +619,7 @@ docker compose up -d</code></pre>INVITE_ONLY=1 # new profiles need an invite codeALLOW_GUEST=0 # remove "Continue without account"</code></pre><p>Register your own passkey profile <i>first</i>, then put your id in- <code>ADMIN_UIDS</code>. You'll get an <b>Admin dashboard</b> link in Settings: who's+ <code>ADMIN_UIDS</code>. You'll get an <b>Admin dashboard</b> link in Settings → Account: who'straining right now, each user's workout history and body weight, disabling an account(signed out and locked out everywhere until re-enabled), and — with invite-only on —generating and revoking invite codes. Admin access rides on your passkey and is enforced@@ -654,12 +654,12 @@ ALLOW_GUEST=0 # remove "Continue without account"</code></pre><h2 id="mobile-server">Connecting the mobile app to your server</h2><p>The mobile app normally keeps everything on the phone. It can instead <b>connect toyour self-hosted instance</b> — your data then lives there, synced like the browser PWA.- Same app, not a different download; offered on first launch and under Settings →+ Same app, not a different download; offered on first launch and under Settings → Account →<b>Connect to my server</b>.</p><p>Passkeys can't work inside the app's WebView (it never runs at your real hostname), sothe device is <b>paired</b> instead:</p><ol>- <li>In a browser that's already signed in: Settings → <b>Pair the mobile app</b> — shows+ <li>In a browser that's already signed in: Settings → Account → <b>Pair the mobile app</b> — showsa one-time code, valid 5 minutes.</li><li>In the app: enter your server's address and that code. Done.</li></ol>@@ -668,7 +668,7 @@ ALLOW_GUEST=0 # remove "Continue without account"</code></pre>paired apps too. Use an HTTPS address if at all possible (the token would otherwisecross the network in plain text). A connected app keeps working without a network on thelast copy it synced — it shows an "Offline" line under the header and pushes your changes- as soon as the connection is back, same as the browser PWA. Settings → <b>Disconnect</b> syncs one last+ as soon as the connection is back, same as the browser PWA. Settings → Account → <b>Disconnect</b> syncs one lasttime, then drops the device cleanly back to local mode. (For the curious: it's<code>POST /api/pair/create</code> + <code>/api/pair/redeem</code> in<code>api/server.js</code>.)</p>@@ -703,7 +703,7 @@ ALLOW_GUEST=0 # remove "Continue without account"</code></pre></ol><h3 id="coach-providers">Providers</h3>- <p>It is <b>off by default</b>. An admin turns it on in <b>Settings → Admin dashboard</b>,+ <p>It is <b>off by default</b>. An admin turns it on in <b>Settings → Account → Admin dashboard</b>,on the <b>AI Coach</b> card, and picks who answers:</p><table class="cfg"><tr><td><b>Anthropic, OpenAI, Google Gemini</b></td><td>Paste an API key from the provider's console. Plain HTTPS from the api process — runs on the default image.</td></tr>@@ -725,7 +725,7 @@ ALLOW_GUEST=0 # remove "Continue without account"</code></pre>- OLLAMA_NUM_PARALLEL=1mem_limit: 4g</code></pre><pre><code>docker exec -it <ollama container> ollama pull qwen2.5:3b</code></pre>- <p>Then on the <b>AI Coach</b> card (<b>Settings → Admin dashboard</b>): provider <b>OpenAI-compatible endpoint</b> →+ <p>Then on the <b>AI Coach</b> card (<b>Settings → Account → Admin dashboard</b>): provider <b>OpenAI-compatible endpoint</b> →Base URL <code>http://ollama:11434</code> → <b>List models</b> → pick the model →<b>Test the Coach</b>. That's the whole setup.</p><p><b>Any model you can pull, you can use.</b> <code>ollama pull</code> whatever you like and@@ -788,7 +788,7 @@ ALLOW_GUEST=0 # remove "Continue without account"</code></pre><a href="https://github.com/DuarteSantos8/openGym/blob/main/mcp/README.md" rel="noopener">mcp/README.md</a>.</p><h2 id="import">Import your training history</h2>- <p>Coming from another tracker? <b>Settings → Data → Import from another app</b> reads a+ <p>Coming from another tracker? <b>Settings → Data & backup → Import from another app</b> reads aCSV export; these apps work without touching the file:</p><table class="cfg"><tr><td><b>FitNotes</b> (Android)</td><td>Settings → Backup/Export → Spreadsheet Export</td></tr>@@ -806,7 +806,7 @@ ALLOW_GUEST=0 # remove "Continue without account"</code></pre><h3 id="imp-hevy">Hevy, directly over the API</h3><p>With <b>Hevy Pro</b>, skip the CSV: create an API key under<a href="https://hevy.com/settings?developer" rel="noopener">Hevy → Settings → Developer</a>,- then in openGym use <b>Settings → Import from Hevy</b>, paste the key (used only for that+ then in openGym use <b>Settings → Data & backup → Import from Hevy</b>, paste the key (used only for thatimport — never saved), and choose any mix of <b>workouts</b>, <b>routines</b> and<b>weigh-ins</b>. Workout days that already have data here are left alone; importedroutines are always added as new plans.</p>@@ -836,7 +836,7 @@ Leg Day,Leg Press,2026-08-21,200,1</code></pre><h2 id="backup">Backups & your data</h2><h3>Per user</h3>- <p><b>Settings → Data → Export backup (JSON)</b> writes your entire log — plan, workouts,+ <p><b>Settings → Data & backup → Export backup (JSON)</b> writes your entire log — plan, workouts,weights, settings — into one file. On the mobile app it goes out through the share sheet(Files, AirDrop, mail…); in the browser it downloads. <b>Import backup</b> restores itanywhere: another phone, your self-hosted instance, or a fresh install. That file is the@@ -930,10 +930,10 @@ Leg Day,Leg Press,2026-08-21,200,1</code></pre><tr><td>"verification failed" on login</td><td><code>RP_ID</code>/<code>ORIGIN</code> don't match the address bar — see the checklist above, starting with what the server logged.</td></tr><tr><td>Media didn't download</td><td><code>docker compose logs media</code>, re-run <code>docker compose up -d</code>, or run <code>./scripts/fetch-media.sh</code>.</td></tr><tr><td>Port 8080 already used</td><td><code>WEB_PORT=9090</code> in <code>.env</code> (and update <code>ORIGIN</code> for local testing).</td></tr>- <tr><td>No "Notifications" option in Settings</td><td>Needs a signed-in profile and HTTPS (or localhost) — guest mode and plain HTTP over LAN can't subscribe.</td></tr>+ <tr><td>No "Reminders" page in Settings</td><td>Needs a signed-in profile and HTTPS (or localhost) — guest mode and plain HTTP over LAN can't subscribe.</td></tr><tr><td>Day reminder fires at the wrong time</td><td>Toggle it off and on so it re-detects your browser's timezone (also happens on every app load).</td></tr><tr><td>"Keep screen awake" shows as unsupported</td><td>The Wake Lock API needs HTTPS or localhost; iOS also refuses it in Low Power Mode.</td></tr>- <tr><td>Want to reset a stuck login</td><td>Delete the cookie — sessions are just signed cookies. "Sign out everywhere" in Settings ends every session (and paired apps) at once.</td></tr>+ <tr><td>Want to reset a stuck login</td><td>Delete the cookie — sessions are just signed cookies. "Sign out everywhere" in Settings → Account ends every session (and paired apps) at once.</td></tr><tr><td><code>docker compose pull</code> says "denied"</td><td>Build from source instead: <code>docker compose up -d --build</code>.</td></tr><tr><td>Exercise images blank in an old build</td><td>Fixed in current images. <code>VITE_IMG_BASE</code>/<code>VITE_GIF_BASE</code> are <b>build-time</b>: they're baked into the bundle when the frontend compiles, so setting them at runtime does nothing to a prebuilt image — redirect media in your reverse proxy instead, or rebuild.</td></tr></table>@@ -947,7 +947,7 @@ Leg Day,Leg Press,2026-08-21,200,1</code></pre><ul><li><b>The app collects nothing.</b> No telemetry, no analytics, no crash reporting, noaccounts on anyone else's server. The mobile app goes online only for exercise- media from a CDN and, when you open Settings, for GitLab's public release list (the update+ media from a CDN and, when you open Settings → About & updates, for GitLab's public release list (the updatecheck). In the browser, a self-hosted instance talks only to your own server.</li><li><b>Passkey private keys never leave your device</b> — the server stores only publickeys.</li>