Document archy-x250-dev3 deployment

Dedicated nginx server block on :8543 (not proxied under the dashboard's
80/443) because the dashboard sets Permissions-Policy: geolocation=()
server-wide, which would silently break Regress's core claim/link
mechanic. Also documents a found-but-not-fixed gap: the dashboard's
app iframe has no allow="geolocation", so the in-dashboard launch path
won't get location access either until that shared component is patched.
This commit is contained in:
2026-08-05 13:41:38 +00:00
parent 8286156412
commit 0bf9b8997c
2 changed files with 74 additions and 0 deletions
+47
View File
@@ -57,3 +57,50 @@ Map's public API.
cd server
npm test
```
## Deployment
Live at **`https://archy-x250-dev3.tail08d8f2.ts.net:8543`** (Tailscale-only —
this node has no public IP, so it isn't reachable from the open internet like
podsteadr is; anyone playing needs to be on the same tailnet).
- Single container (`Dockerfile`, server + built frontend in one image),
`podman run --restart unless-stopped`, data on a bind-mounted volume at
`/var/lib/archipelago/regress-data` on the node.
- Fronted by a dedicated nginx server block, `deploy/nginx-archy-node.conf`,
on its own port (**8543**) rather than being proxied under the node's main
dashboard (80/443).
**Why a dedicated port, not `/app/regress/` like other installed apps:**
archipelago's own nginx config sets `Permissions-Policy:
geolocation=()` server-wide on its 80/443 blocks — inherited by every
`location` under them that doesn't set its own `add_header`s. Regress's
entire claim/link mechanic depends on `navigator.geolocation`, so being
proxied under those blocks would silently break the core game with no
clear error. A separate server block sidesteps this entirely and sets
`Permissions-Policy: geolocation=(self)` explicitly.
**Also found, not yet fixed:** the Archipelago dashboard's own app-iframe
element (`neode-ui/src/views/appSession/AppSessionFrame.vue`) has no
`allow="geolocation"` attribute, so even a geolocation-permitting app would
have geolocation blocked by the browser's default iframe permission
delegation if launched *inside* the dashboard iframe. This isn't
Regress-specific — it'd affect any app needing geolocation. Until that's
patched (a shared-component change, out of scope for this deploy), players
should open Regress directly (the URL above, or "open in new tab" from the
dashboard) rather than through the in-dashboard iframe.
- Non-standard port gotcha: nginx's `$host` variable strips the port before
forwarding, which breaks NIP-98 login (`u` tag URL won't match). Use
`proxy_set_header Host $http_host;` (preserves the original port) — already
set correctly in `deploy/nginx-archy-node.conf`.
- `PUBLIC_URL` passed to the container must include the `:8543` for the same
reason.
To redeploy after a code change: `git pull` in
`/var/lib/archipelago/regress-src` on the node, `podman build -t
localhost/regress:latest .`, then `podman run -d --name regress-app --replace
--restart unless-stopped -p 127.0.0.1:8199:8199 -v
/var/lib/archipelago/regress-data:/data -e
PUBLIC_URL=https://archy-x250-dev3.tail08d8f2.ts.net:8543
localhost/regress:latest`.