Skip to main content

Troubleshooting

Common issues and their solutions.

Installation Issues​

Problem: Installation fails with permission errors​

Solution: Use npm/composer with appropriate permissions or use a version manager.

Problem: Dependencies conflicts​

Solution: Clear cache and reinstall:

npm cache clean --force && npm install

Runtime Issues​

Problem: Application fails to start​

Solution:

  1. Check all prerequisites are installed
  2. Verify configuration files
  3. Check logs for error messages

Problem: Performance issues​

Solution:

  1. Check system resources
  2. Review configuration settings
  3. Enable debugging to identify bottlenecks

Getting Help​

  1. Check this troubleshooting guide
  2. Search existing issues on GitHub
  3. Open a new issue with detailed information
  4. Provide logs and system information

Common Commands​

# Clear all caches
npm run clean

# Reset to clean state
rm -rf node_modules && npm install

# Check system status
npm run doctor