Common Errors
If you encounter issues during installation or updates, check the categories below for potential causes.
1. 500 Internal Server Error
- •Missing .env file or missing APP_KEY
- •Incorrect file/folder permissions on storage and bootstrap/cache
2. Class Not Found / Composer Autoload Error
- •Vendor dependencies missing after a fresh deploy
- •Autoloader is stale after pulling new code
3. Database Connection Error
- •Database credentials in .env do not match the database user
- •Database server is not reachable from the application server
4. Invalid or Missing APP_KEY
- •APP_KEY was never generated or was accidentally removed from .env
- •Encrypted session/cookie data fails to decrypt, causing repeated logouts
5. CSS/JS Not Loading
- •APP_URL in .env does not match the actual domain (including https)
- •Frontend assets were not built for production
6. Storage Link / Uploaded Images Not Showing
- •The public/storage symlink was never created
- •Uploaded files (logos, feature images, etc.) 404 on the frontend
7. Migration Errors on Update
- •A previous migration failed halfway through
- •Database user lacks ALTER/CREATE privileges needed for schema changes