skill

Octolux App Server — debug startup and runtime failures

Public Unreviewed

by Caleb

Diagnose any Octolux Node.js app server failure that breaks the Dashboard (startup or runtime). Six symptoms with root causes and fixes.

Overview Files Skills Discover Packages Releases Dependencies Issues Breadcrumbs Pull Requests Activity

Discover

How an AI finds this repo: the auto-discovery snippet from page.json, self-tested against the live discovery search.

Snippet

discovery_triggers
octolux server not runningoctolux dashboard erroroctolux dashboard blankoctolux dashboard won't loadoctolux health failingoctolux app serveroctolux server.js crashoctolux 8830ECONNREFUSED 0.0.0.0:8830octolux econnrefusedoctolux ws module not foundERR_MODULE_NOT_FOUND octoluxoctolux first runoctolux fresh containeroctolux server logwhere do octolux logs gocan't reach octolux dashboardoctolux EADDRINUSEoctolux port already in useoctolux silent crashoctolux vnc button doesn't workoctolux dashboard button does nothingclicking VNC opens nothingoctolux deploy button brokenoctolux section button first clickdashboard tab created but invisiblehydrogen open-or-refresh active-tabhydrogen browser session disconnectedno browser session is connectedhydrogen 409hydrogen workspace mutations failingrefresh hydrogen editor taboctolux dashboard every click does nothingoctolux server returns ok true but nothing happensadom-cli silent failureexecFile error swalloweddashboard 502 stripped bodyadom proxy body strippingoctolux toast error
discovery_pitch

Debug the Octolux Node.js app server (port 8830). Covers six symptoms across startup failures (ECONNREFUSED, missing npm deps, EADDRINUSE, silent crashes) and runtime feature bugs — including the dashboard section-button bugs where (a) the first click creates a tab behind the dashboard and (b) every click silently fails because Hydrogen's workspace session has disconnected and the server's cli() wrapper drops the 409 on the floor. Also documents the Adom HTTPS proxy 5xx-body-stripping gotcha that forces using HTTP 200 with {ok:false}.

tags
none
sample_prompts
Dashboard blankThe Octolux dashboard webview is blank — diagnose it
Server won't startoctolux health says the server isn't running
Port already in useEADDRINUSE 0.0.0.0:8830 when I start the Octolux server
Module not foundERR_MODULE_NOT_FOUND when I start the Octolux server
Silent crashOctolux server starts and dies a few seconds later
Click does nothingClicking VNC (or Deploy / Stream) on the Octolux dashboard does absolutely nothing — every click, not just the first
Hydrogen 409adom-cli is returning 409 'No browser session is connected' from open-or-refresh
Prevent recurrenceHow do I stop new containers hitting the Octolux first-run ECONNREFUSED bug?

Sample prompts: self-test

Your own triggers, combined #1 of 156

How this repo ranks when its full trigger set is the query.

Each sample prompt run against the live discovery search. The score is your rank, does the prompt return this repo at the top?

"The Octolux dashboard webview is blank — diagnose it"Dashboard blank #1 of 153
1. caleb/octolux-app-server-debug this repo score 18.00
2. adom/adom-remote-control score 11.00
3. kyle/kicad-pcb-viewer score 11.00
"octolux health says the server isn't running"Server won't start #1 of 103
1. caleb/octolux-app-server-debug this repo score 13.00
2. adom/session-monitor-cli score 6.00
4. adom/adom-vscode score 4.00
5. kyle/skill-pilot score 4.00
"EADDRINUSE 0.0.0.0:8830 when I start the Octolux server"Port already in use #1 of 156
1. caleb/octolux-app-server-debug this repo score 17.00
2. adom/session-monitor-cli score 10.00
5. adom/adom-vscode score 7.00
"ERR_MODULE_NOT_FOUND when I start the Octolux server"Module not found #1 of 156
1. caleb/octolux-app-server-debug this repo score 14.00
2. adom/session-monitor-cli score 10.00
5. adom/adom-vscode score 7.00
"Octolux server starts and dies a few seconds later"Silent crash #1 of 156
1. caleb/octolux-app-server-debug this repo score 10.00
2. adom/adom-vscode score 7.00
4. adrianwowk/test score 7.00
5. adom/adom-desktop score 6.00
"Clicking VNC (or Deploy / Stream) on the Octolux dashboard does absolutely nothing — every click, not just the first"Click does nothing #1 of 155
1. caleb/octolux-app-server-debug this repo score 38.00
4. adom/adom-desktop score 12.00
5. adom/wiki score 10.00
"adom-cli is returning 409 'No browser session is connected' from open-or-refresh"Hydrogen 409 #1 of 111
1. caleb/octolux-app-server-debug this repo score 18.00
2. adom/adom-remote-control score 9.00
3. adom/adom-desktop score 7.00
5. adom/adom-cli score 7.00
"How do I stop new containers hitting the Octolux first-run ECONNREFUSED bug?"Prevent recurrence #2 of 156
2. caleb/octolux-app-server-debug this repo score 13.00
3. adom/adom-desktop score 12.00
5. adom/wiki score 12.00