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

28 lines
909 B
Markdown

# Troubleshooting
## `Scoreko app folder does not exist`
- Verify `lib/scoreko-dev` exists.
- Make sure the project contains the scoreko-dev bundle root with its own `package.json`.
## `No read/write permissions on scoreko app folder`
- Adjust permissions on `lib/scoreko-dev` for the user running Electron.
- On Linux/macOS: `chmod -R u+rw lib/scoreko-dev` (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 scoreko-dev dependencies (`cd lib/scoreko-dev && npm install`).
## macOS build fails because of icon
- The configuration expects `static/icons/icon.icns`.
- Create that file before running macOS packaging.