Troubleshooting

Common Issues

500 Server Error After Installation

This usually indicates a configuration issue:

• Check that .env file exists and has correct database credentials
• Ensure APP_KEY is set (run php artisan key:generate)
• Verify file permissions on storage/ and bootstrap/cache/
• Check PHP version meets minimum requirements (8.2+)

# Fix permissions
chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

# Clear caches
php artisan config:clear
php artisan cache:clear
php artisan view:clear

Payment Gateway Errors

• Stripe: Verify webhook secret matches your Stripe dashboard
• PayPal: Ensure PAYPAL_MODE matches your credential type (sandbox vs live)
• Razorpay: Check that your account is activated for live payments

Email Not Sending

• Verify mail configuration in .env
• Test with php artisan tinker and send a test email
• Check storage/logs/laravel.log for error details
• For Gmail, enable "Less secure app access" or use an App Password

Maps Not Loading

• Verify GOOGLE_MAPS_API_KEY is set in .env
• Ensure Maps JavaScript API and Places API are enabled in Google Cloud Console
• Check that your API key has no IP restrictions blocking your server

Performance Optimization

If your site is running slowly:

# Optimize for production
php artisan optimize
php artisan view:cache
php artisan event:cache

# Enable OPcache in php.ini
opcache.enable=1
opcache.memory_consumption=256

Getting Support

If you can't resolve your issue:

• Check the Support page for FAQs
• Submit a support ticket with error logs
• Include your PHP version, server environment, and steps to reproduce