Skip to content

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.

Docs: Settings paths for the new pages

Duarte Santosbb94798f85de
diff --git a/docs/AI_COACH.md b/docs/AI_COACH.md
index 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 top
of the same card. A provider that is connected and passes **Test the Coach** is not enough
on its own: with the switch off, the server tells every app there is no Coach, and the card
reads *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 it
answers 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 never
that flow — it only ever receives the finished token. (Claude also accepts an Anthropic API key
here, 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 they
opt in themselves (**Compare with others here → Include me** in the Coach chat). The trade is
symmetric: 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 the
phone). A paired phone is an ordinary profile: the Coach runs on your server with whatever
provider 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 endpoint
diff --git a/docs/DATA_IMPORTS.md b/docs/DATA_IMPORTS.md
index 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 of
your own exercises, so nothing in the file is dropped. Days that already have a workout in openGym
are 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 somethin
With **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 this
import 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 each
workout 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.md
index 052312492..e68a3b388 100644
--- a/docs/FAQ.md
+++ b/docs/FAQ.md
@@ -36,7 +36,7 @@ checks for updates itself. Get it from the
On a self-hosted instance, in the `./data` folder next to `docker-compose.yml`: one JSON file per
profile plus the account list. Back up that folder and you've backed up everything. In the phone app
it'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.md
index 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 never
matches 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 (valid
5 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, and
changes 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 **paired
again**; 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, the
phone drops cleanly back to local mode. If not, it says how many changes are missing and
offers **Try again**, **Export backup**, or **Disconnect anyway** — which keeps those
changes 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 phone
last held exactly what the server holds, how many changes are still waiting, and a **Sync
now** button that says how it went. Whenever the app is *not* connected, a line under the
status 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 on
by default, and the setting travels with your profile). A phone kept local on purpose then shows
nothing at all. On a phone with a server, a problem — offline, an error, a refused phone, or
changes 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. Pairing
again 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 another
account 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 on
changes** switched on: a dated copy after every finished workout or edited routine, in a
folder 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. One
file per day; each new copy deletes all but the newest 14 of these dated files in that
folder. Nothing else is deleted, in that folder or anywhere: other files you keep there, and
the 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 the
system 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 folder
stops 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 with
an `.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 share
sheet; **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 down
with the phone's token into the same folder, so they show offline too. A file that has not
reached 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 an
app's whole backup past 25 MB, and a few videos would take the state file down with them. A
diff --git a/docs/SELF_HOSTING.md b/docs/SELF_HOSTING.md
index 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 my
server" mode: instead of a passkey ceremony (impossible from inside its WebView, which never
runs 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 token
sent as an `Authorization` header rather than a cookie. Two consequences worth knowing if
you'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 training
right now, each user's workout history and body weight, the ability to disable an account (signed
out and locked out everywhere until you re-enable it), and — with `INVITE_ONLY=1` — generating and
revoking 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 login
An 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, and
profiles that existed before this setting keep the language they have — the app cannot tell an
old 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 i
that 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 is
on, `audit.log` with everyone's sign-in times. Worth knowing before you ship the archive to a
backup 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 makes
the 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 a
placeholder until one of its owner's devices — each keeps its own copy — uploads it again. When
you 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 everyth
openGym 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 and
HTTPS — 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 or
restarting is still sent up to 15 minutes late, once; the browser re-registers its subscription
with 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: the
Wake Lock API is only available over HTTPS or on `http://localhost`, so on a plain-LAN-IP
instance the switch shows as unsupported. Nothing to configure server-side either way, and iOS
refuses 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 give
passkey 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 still
signed 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 second
passkey 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.html
index 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 &rarr; Data
+ before installing. <b>Updates come to you:</b> when a newer release exists, Settings &rarr; About &amp; updates
shows "openGym vX available" &mdash; one tap downloads the signed APK, checks its SHA-256
against the published checksum and opens the installer (no checksum, no install; the first
time Android asks for the "install unknown apps" permission). Installing over the old
version by hand works too &mdash; 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 &mdash; when you open
- Settings &mdash; a look at the public release list on GitLab to see whether a newer
+ Settings &rarr; About &amp; updates &mdash; a look at the public release list on GitLab to see whether a newer
version exists.</p>
<p>The app requests notification permission only when you switch the workout-day reminder
on, 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 a
workout to another date without touching the weekly plan itself — the override applies
to that date only.</li>
- <li><b>Weeks start where you say.</b> Monday or Sunday, in Settings &rarr; General. The
+ <li><b>Weeks start where you say.</b> Monday or Sunday, in Settings &rarr; Plan &amp; schedule. The
weekly plan, the day strip on Home, the calendar grid and every &ldquo;this week&rdquo;
total &mdash; the workout count, the week streak, the seven-day muscle balance &mdash;
all follow it. Existing profiles keep the Monday week they have been looking at.</li>
@@ -358,7 +358,7 @@
name &mdash; note, details, progression, bar weight, warm-up set, superset with the
previous or next exercise, swap, move, remove &mdash; and the set number is the set's own
menu (drop set, rest-pause burst, remove). Nothing else sits between you and the numbers.
- Miss a button? Settings &rarr; During a workout &rarr; <b>Workout controls</b> brings any
+ Miss a button? Settings &rarr; Workout &rarr; <b>Fine-tuning</b> brings any
group back: +/&minus; steppers, drop/burst shortcuts on every row, superset buttons in
the header, move/swap/remove below the card.</li>
<li><b>List view keeps the header pinned</b> &mdash; name, clock, set counter, discard and
@@ -379,10 +379,10 @@
it. On Android the countdown also sits in a notification, with Pause and &plusmn;15&nbsp;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 &rarr; During a workout). Hidden collapses
+ hidden entirely during a workout (Settings &rarr; Workout). Hidden collapses
the 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 &rarr; Workout. (Needs HTTPS or
localhost; 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 one
you 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 with
the 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 code
ALLOW_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's
training 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 to
your 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), so
the 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> — shows
a 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 otherwise
cross the network in plain text). A connected app keeps working without a network on the
last 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 last
time, 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&nbsp;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=1
mem_limit: 4g</code></pre>
<pre><code>docker exec -it &lt;ollama container&gt; 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 &amp; backup → Import from another app</b> reads a
CSV 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 &amp; backup → Import from Hevy</b>, paste the key (used only for that
import — 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; imported
routines 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 &amp; 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 &amp; 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 it
anywhere: 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, no
accounts 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 &amp; updates, for GitLab's public release list (the update
check). 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 public
keys.</li>