# Troubleshooting

## `No existe la carpeta NodeCG`

- Verifica que exista `lib/nodecg`.
- Asegúrate de que el proyecto contiene una instalación completa de NodeCG.

## `Sin permisos de lectura/escritura sobre NodeCG`

- Ajusta permisos de `lib/nodecg` para el usuario que ejecuta Electron.
- En Linux/macOS: `chmod -R u+rw lib/nodecg` (según tu política local).

## `El puerto <PORT> ya está en uso`

- Libera el puerto o define `NODECG_PORT` en `.env`.
- Usa `npm run doctor` para validar disponibilidad antes de arrancar.

## `Timeout esperando NodeCG`

- Revisa logs de NodeCG en la salida estándar.
- Incrementa `NODECG_STARTUP_TIMEOUT_MS` si el entorno es lento.
- Verifica dependencias de NodeCG (`cd lib/nodecg && npm install`).

## Build macOS falla por icono

- La configuración espera `static/icons/icon.icns`.
- Crea ese archivo antes de ejecutar empaquetado para macOS.