Fixes

Follow these recommended steps to resolve the issues listed on the Common Errors page.

500 Internal Server Error
  • Copy .env.example to .env if it does not already exist
  • Generate a new application key with php artisan key:generate
  • Fix permissions on the storage and bootstrap/cache folders
Class Not Found / Composer Autoload Errors
  • Run composer install to restore missing vendor packages
  • Run composer dump-autoload to rebuild the autoloader
  • Clear cached configuration with php artisan config:clear
Database Connection Error
  • Recheck DB_HOST, DB_DATABASE, DB_USERNAME and DB_PASSWORD in .env
  • Confirm the database server is reachable from the app server
  • Ensure the database user has full privileges on the database
CSS/JS Not Loading
  • Set APP_URL in .env to match your real domain, including https
  • Rebuild frontend assets with npm install and npm run build
  • Clear the browser cache and reload the page
Storage Link / Uploaded Images Not Showing
  • Run php artisan storage:link to create the public storage symlink
  • Confirm the storage/app/public folder has correct permissions
  • Re-upload the affected files after linking storage
Migration Errors On Update
  • Back up the database before retrying any migration
  • Verify the database user has ALTER and CREATE privileges
  • Run php artisan migrate again after resolving the stuck entry
Additional Tips
  • • Always take a database backup before running migrations
  • • Keep your .env file out of version control
  • • Re-run storage:link and config:clear after every deployment

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