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.

Clarify push service address handling in SELF_HOSTING.md

Viktor Shapovalc27c3836eaa4
diff --git a/docs/SELF_HOSTING.md b/docs/SELF_HOSTING.md
index f065683da..976acd76b 100644
--- a/docs/SELF_HOSTING.md
+++ b/docs/SELF_HOSTING.md
@@ -633,12 +633,10 @@ in `.env` if you would rather they had an inbox.
### Push endpoints on private addresses (`ALLOWED_PRIVATE_IPS`)
-The api container connects out to the push service address each browser registers. To protect the
-other services on your network, it refuses any address that is private, loopback, link-local,
-CGNAT or reserved — for a hostname, after DNS resolution. Some DNS setups resolve public push
-services to private addresses on purpose, for example FakeDNS, a DNS-based proxy or a
-split-horizon resolver. Push then fails and the api log shows `refusing to connect to a private
-address`.
+The api container resolves push service domains to the IPs. Private IPs are banned by default.
+But some DNS setups resolve public domains to private addresses on purpose, for example FakeDNS, a DNS-based proxy or a
+split-horizon resolver.
+Push then fails and the api log shows `refusing to connect to a private address`.
Set `ALLOWED_PRIVATE_IPS` in `.env` to the private addresses that are safe to reach:
@@ -650,8 +648,6 @@ ALLOWED_PRIVATE_IPS=10.0.0.0/8, 192.168.1.50, 172.16.0.1-172.16.0.9, fd00::/8
- Separate entries with commas or spaces.
- An entry is a single IP address, a range (`first-last`) or a CIDR block. IPv4 and IPv6 both work.
- An IPv4 entry also covers the same address written as IPv4-mapped IPv6 (`::ffff:10.1.2.3`).
-- An entry that is not valid prints a warning in the api log and is ignored.
-- The list is read once at start. Restart the api container after you change it.
- The default is empty: every private address stays blocked. Keep the list as small as you can —
each address you allow is an address that a signed-in user can make the server connect to.