Fixes

Follow these recommended steps to resolve common issues encountered during the setup or operation of AdRadio.

500 Internal Server Error
  • Generate the app key with php artisan key:generate
  • Confirm the .env file exists and is configured
  • Check storage/logs/laravel.log for the exact error
Server Requirement Failed
  • Enable missing PHP extensions from hosting panel
  • Upgrade PHP version to the required version
  • Restart web server after changes
Database Connection Error
  • Recheck database name, username, and password in .env
  • Confirm database host and port
  • Ensure database user has full privileges
Composer Install Failed
  • Enable required PHP extensions from the hosting panel
  • Increase PHP memory limit or use composer install --no-dev
  • Run composer dump-autoload after a successful install
Migration Failed
  • Verify database user permissions
  • Increase PHP memory limit
  • Run php artisan migrate:fresh --seed on a clean database
Admin Panel Not Accessible
  • Check server error logs
  • Clear application cache with php artisan optimize:clear
  • Ensure installation completed successfully
Storage / Media Not Loading
  • Run php artisan storage:link to create the symlink
  • Set correct permissions on the storage folder
  • Confirm APP_URL in .env matches your domain
Mobile App Not Connecting to API
  • Confirm correct API base URL in app configuration
  • Ensure SSL certificate is installed
  • Check server firewall or CORS settings
Cached Config / Push Notifications Issue
  • Run php artisan optimize:clear after editing .env
  • Recheck Firebase project configuration
  • Upload the correct configuration files
Additional Tips
  • • Always use a fresh database for installation
  • • Avoid running the installer multiple times
  • • Backup files and database before updates

If an issue persists after following these steps, pleasecontact supportwith detailed information and screenshots.