Common Issues & Solutions

Common Issues & Solutions

Quick solutions to frequent problems.

Installation Issues

"500 Internal Server Error"

• Check .htaccess file
• Verify PHP version (8.2+)
• Check file permissions
• Enable debug mode
• Review error logs

"Database Connection Failed"

• Verify credentials in .env
• Check MySQL service
• Confirm database exists
• Test connection manually

Email Problems

Emails not sending:

1. Verify SMTP settings
2. Check credentials
3. Test with different provider
4. Check spam folder
5. Verify queue workers

Emails in spam:

• Configure SPF records
• Setup DKIM
• Use reputable SMTP
• Avoid spam words
• Include unsubscribe

Payment Issues

Payment not processing:

• Verify API keys
• Check webhook URLs
• Test in sandbox mode
• Review gateway logs
• Contact payment provider

Refunds not working:

• Check gateway permissions
• Verify API access
• Manual refund option
• Update order status

Performance Issues

Site running slow:

1. Enable caching
2. Optimize images
3. Use CDN
4. Minimize CSS/JS
5. Upgrade hosting

High server load:

• Check active users
• Review database queries
• Enable query caching
• Optimize indexes
• Scale resources

User Issues

Can't login:

• Reset password
• Clear browser cache
• Check account status
• Verify email
• Remove IP block

Registration failing:

• Check reCAPTCHA
• Verify email service
• Review validation rules
• Check spam filters

File Upload Problems

Images not uploading:

• Check file size limits
• Verify file types
• Storage permissions
• PHP upload limits
• Disk space available

Search Not Working

Fix search issues:

1. Rebuild search index
2. Check Elasticsearch
3. Verify permissions
4. Clear cache
5. Update settings