Common Installation Issues

500 Internal Server Error

This usually indicates a PHP configuration issue. Check:

• PHP version is 8.2 or higher
• All required PHP extensions are installed
• File permissions are correct (directories: 755, files: 644)
• Storage and bootstrap/cache directories are writable

Blank White Page

Enable debug mode temporarily in your .env file:

APP_DEBUG=true

Check the error, fix it, then set APP_DEBUG=false in production.

Asset Not Loading (CSS/JS)

Run these commands:

php artisan cms:publish:assets
php artisan optimize:clear