- Settings → Remote devices → Node: type master|slave (stored in state, beats
config role; Restart DSH button under systemd/launchd), origin (read-only:
own origin / paired master), 'Master has an auth middleware' toggle
- middleware on: a non-DSH answer on the link (login redirect, 401/403, inline
HTML) raises auth-required; the UI opens <master>/dsh-remote/signin in a popup,
the user signs in to the proxy, one click hands the proxy session cookie back
(postMessage, origin-checked, trusted origins only), link retries
- edge mode 'cookie': pasted authentik_proxy_… (or a whole Cookie header),
rotated proxy cookies persisted back; pair.mjs/install-mac --edge cookie
- connectMaster serialised; a failed attempt never clears a finished link
- tests: cookie seed/mode, HTML login wall; e2e-signin against a fake proxy
- deploy/install-mac.sh: per-user Node 22 (checksum-verified), DSH + pnpm in
~/.local, dsh-remote from the repo archive, pairing, LaunchAgent dsh web
- deploy/pair.mjs: pair without a running DSH (detects login-proxy redirects)
- install-local.mjs: --accept secrets list, --restart-on-sync
- sync.restartOnSync: slave restarts itself after synced plugins change
(waits for idle sessions, at most once per 10 min)