Common Issues & Fixes

500 Server Error on Fresh Install

• Make sure APP_KEY is set — run php artisan key:generate
• Check storage/logs/laravel.log for the real error message
• Ensure storage/ and bootstrap/cache/ are writable (chmod -R 775)

404 on All Pages (except homepage)

• Apache: Make sure mod_rewrite is enabled and AllowOverride All is set in your vhost config
• Nginx: Add try_files $uri $uri/ /index.php?$query_string; to your server block
• Ensure your web root points to the public/ folder, not the project root

Images / Uploads Not Showing

• Run php artisan storage:link to create the symlink between storage/app/public and public/storage
• Verify storage/app/public/ is writable

Google Login Not Working

• Verify the redirect URI in Google Cloud Console exactly matches: https://yourdomain.com/auth/google/callback
• Make sure the Google Login toggle is enabled in Admin → Settings → Social
• Clear config cache: php artisan config:clear

Emails Not Being Sent

• Check SMTP credentials in Admin → Settings → Mail
• Use the Send Test Email button to diagnose
• Check if your hosting provider blocks port 587 (try port 465 with SSL)

Clearing Caches

If you see stale content after changes, go to Admin → Settings → Tools and click Clear All Caches, or run:

php artisan view:clear
php artisan config:clear
php artisan cache:clear
php artisan route:clear