Common Issues & Fixes

Common Issues & Fixes

Emails Not Sending

• Check your SMTP credentials under Settings → Email
• Ensure the queue worker is running: php artisan queue:work or via Horizon
• Check email logs: Settings → Email → Log
• Test via Settings → Email → Send Test Email

Orders Stuck in "Pending" Status

• Check whether the payment gateway webhook is configured correctly
• For Stripe: ensure the webhook endpoint is registered in Stripe Dashboard
• For bKash: verify your IPN callback URL is accessible from bKash servers
• Manually update order status as a temporary fix while investigating

Images Not Showing

• Ensure the storage symlink is created: php artisan storage:link
• Check file permissions on the storage/app/public directory (needs to be writable)
• Clear cache: php artisan optimize:clear

Slow Performance

• Enable Redis caching: set CACHE_DRIVER=redis in your .env
• Run php artisan optimize to cache routes, config, and views
• Ensure Horizon/queue workers are running for background jobs
• Enable OPcache in your PHP configuration

License Activation Fails

• Ensure your server can make outbound HTTPS requests
• Check that the license key was copied without extra spaces
• Verify you haven't exceeded the activation limit
• Use offline activation if the server is firewalled