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