Common Issues

Common Issues

500 Internal Server Error

Cause: Usually a misconfigured .env file or missing permissions.

Solution:

• Check storage/logs/laravel.log for the detailed error
• Ensure storage/ and bootstrap/cache/ are writable
• Verify database credentials in .env
• Run php artisan config:clear

Coupons Not Importing

Cause: Affiliate network API keys not configured or cron job not running.

Solution:

• Verify API keys in Admin -> Settings -> Affiliate Networks
• Check that the cron job is running: php artisan schedule:list
• Run manual import to test: php artisan coupons:import --network=all
• Check import logs in Admin -> Automation -> Import Logs

Store Logos Not Loading

Cause: Storage symlink not created.

Solution:

php artisan storage:link

Blank White Page

Cause: PHP error with display_errors disabled.

Solution:

• Temporarily set APP_DEBUG=true in .env
• Check PHP error logs
• Common fix: composer install to restore dependencies

Slow Page Loading

Cause: Missing optimization or too many uncached database queries.

Solution:

php artisan config:cache
php artisan route:cache
php artisan view:cache
composer install --optimize-autoloader --no-dev