Perfect_Python500/Webka
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

DUNGEONS-34: simplify HTTPS with an existing remote proxy #4

Merged
Perfect_Python500 merged 1 commits from codex/dungeons-34-proxy-homepage into main 2026-09-06 12:45:03 +00:00
Conversation 0 Commits 1 Files Changed 6 +306 -21
Perfect_Python500 commented 2026-09-06 12:43:37 +00:00
Owner
Copy Link

Webka can now run behind an existing HTTPS proxy on another computer with npm run dev:all -- --homepage https://camera.example.com --port 3002. Homepage mode binds to 0.0.0.0 by default, disables mDNS, and configures the public origin, Secure cookies, and QR/share URL while serving HTTP to the proxy. Explicit host options remain supported.

Add optional webka.config.json persistence with CLI overrides and document Nginx Proxy Manager upstream, WebSocket, and certificate settings. Existing local/LAN startup defaults stay compatible.

Validation on Node 22.23.2 / npm 10.9.8:

  • Eight launcher unit tests passed, including config parsing and stale environment overrides.
  • Local/LAN integration passed: login, startup/restart, port conflicts, and Ctrl+C cleanup.
  • Local HTTPS reverse-proxy integration passed: frontend, login, Secure cookie, homepage share URL, origin rejection, WSS handshake/welcome, and shutdown. This uses a test proxy, not the user's NPM instance.
  • JavaScript syntax and diff whitespace checks passed.

Closes DUNGEONS-34.

Webka can now run behind an existing HTTPS proxy on another computer with `npm run dev:all -- --homepage https://camera.example.com --port 3002`. Homepage mode binds to `0.0.0.0` by default, disables mDNS, and configures the public origin, Secure cookies, and QR/share URL while serving HTTP to the proxy. Explicit host options remain supported. Add optional `webka.config.json` persistence with CLI overrides and document Nginx Proxy Manager upstream, WebSocket, and certificate settings. Existing local/LAN startup defaults stay compatible. Validation on Node 22.23.2 / npm 10.9.8: - Eight launcher unit tests passed, including config parsing and stale environment overrides. - Local/LAN integration passed: login, startup/restart, port conflicts, and Ctrl+C cleanup. - Local HTTPS reverse-proxy integration passed: frontend, login, Secure cookie, homepage share URL, origin rejection, WSS handshake/welcome, and shutdown. This uses a test proxy, not the user's NPM instance. - JavaScript syntax and diff whitespace checks passed. Closes DUNGEONS-34.
Perfect_Python500 added 1 commit 2026-09-06 12:43:43 +00:00
DUNGEONS-34: simplify external HTTPS proxy setup 75e8fec4fe 
Co-authored-by: multica-agent <github@multica.ai>
Perfect_Python500 merged commit ae3a3c5def into main 2026-09-06 12:45:03 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Perfect_Python500
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Perfect_Python500/Webka#4
Delete Branch "codex/dungeons-34-proxy-homepage"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?