Avanzado
Solución de Problemas
Conflictos de Puertos en Docker
Si al ejecutar `docker compose up -d` recibes el error `port is already allocated` (puerto 5432 o 27017 en uso):
✓ Causa: Tienes otra instancia local de PostgreSQL o MongoDB ejecutándose en tu máquina fuera de Docker.
✓ Solución: Detén el servicio local de PostgreSQL o edita el archivo `docker-compose.yml` para mapear el puerto del host a otro número (ej: `"5433:5432"`).
Permisos de Ejecución en macOS y Linux
Si descargas el binario directamente desde GitHub Releases y obtienes `permission denied` o advertencias del sistema de seguridad:
✓ En Linux/macOS: Otorga permisos de ejecución con `chmod +x koko`.
✓ En macOS (Gatekeeper): Si el sistema bloquea el binario por no estar firmado, ejecuta `xattr -d com.apple.quarantine koko` o abre Preferencias del Sistema > Privacidad y Seguridad > Permitir de todos modos.
Resolución de Dependencias en Monorrepos (pnpm)
Si experimentas problemas al enlazar paquetes locales en `packages/db`:
✓ Asegúrate de estar usando `pnpm` (versión 9 o superior).
✓ Ejecuta `pnpm install` desde la raíz del proyecto para que los enlaces simbólicos de los workspaces se resuelvan correctamente.