44 lines (29 loc) · 1.38 KB

Troubleshooting

The site returns 502 / Bad Gateway

In most cases this is a proxy issue, not an OfferPotato crash.

Check the service directly:

curl --noproxy '*' http://127.0.0.1:6324/api/health

If you get {"ok":true}, the server is healthy and your proxy path is the problem.

Fixes:

add 127.0.0.1 and localhost to NO_PROXY
add your LAN IP to the browser or system proxy bypass list
access the exact URLs printed by OfferPotato on startup

The UI loads but documents do not refresh

Confirm the file was opened from the document panel
Confirm the server still has access to the underlying local file
Confirm the file watcher is not blocked by network filesystem permissions

Generated answers show local absolute paths

Run npm run clean:data
rebuild the DB from the public-safe default config
regenerate answers after the rebuild

The embedded terminal does not connect

confirm codex is installed and available in PATH
confirm websocket traffic is not intercepted by a proxy
reload the page and click 重启会话

New sources do not appear

confirm the new directory is placed under sources/documents/ or sources/question-banks/
open Settings and check whether the auto-discovery counter has increased
save and rebuild the index after adding new sources
if you do not want a directory auto-detected, move it out of sources/

⚡