# 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.