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: behind an auth proxy, let the icons and the manifest through without a login

Boris Kurktchiev7abada3bfcda
diff --git a/docs/SELF_HOSTING.md b/docs/SELF_HOSTING.md
index 370f8e5f6..5551f5aa6 100644
--- a/docs/SELF_HOSTING.md
+++ b/docs/SELF_HOSTING.md
@@ -159,6 +159,16 @@ same device.
Prefer to keep the whole thing off the open internet? A VPN or an auth proxy (Authelia, Cloudflare
Access…) in front still works, and composes with the above.
+Behind an auth proxy, let three files through without a login: `/icon-180.png`, `/icon-512.png`
+and `/manifest.json` — the app's icon and its manifest, nothing personal in them. iOS fetches the
+Home Screen icon outside the page, without your session cookie, so a gated icon comes back as the
+proxy's login page and iOS 26 draws a letter tile instead of the dumbbell (observed on iOS 26.6
+behind Teleport; Authelia users know the same from favicons and manifests). Authelia: a `bypass`
+rule for those paths; Authentik: unauthenticated paths; Cloudflare Access: a bypass policy;
+oauth2-proxy: `skip_auth_routes`. A proxy that cannot exempt a path (Teleport) has to serve the
+icons inline as `data:` URLs instead — Safari 26 accepts those, older iOS does not, which is why
+that is not the default here.
+
## 5. Fitting it into an existing stack
The defaults assume openGym is the only thing here: a service called `api` on port 3000, and nginx