Files
scoreko-electron-dev/docs/troubleshooting.md
T

28 lines
838 B
Markdown

# Troubleshooting
## `NodeCG folder does not exist`
- Verify `lib/nodecg` exists.
- Make sure the project contains a full NodeCG installation.
## `No read/write permissions on NodeCG`
- Adjust permissions on `lib/nodecg` for the user running Electron.
- On Linux/macOS: `chmod -R u+rw lib/nodecg` (according to your local policy).
## `Port <PORT> is already in use`
- Free the port or set `NODECG_PORT` in `.env`.
- Use `npm run doctor` to validate availability before startup.
## `Timeout while waiting for NodeCG`
- Check NodeCG logs in standard output.
- Increase `NODECG_STARTUP_TIMEOUT_MS` if the environment is slow.
- Verify NodeCG dependencies (`cd lib/nodecg && npm install`).
## macOS build fails because of icon
- The configuration expects `static/icons/icon.icns`.
- Create that file before running macOS packaging.