Troubleshooting

First move, always:

php artisan storemine:preflight

It diagnoses most of the issues below automatically.

Common issues

SymptomLikely cause & fix
500 error after installMissing APP_KEY → php artisan key:generate, then php artisan config:cache
Blank page / unstyled siteFrontend not built → npm ci && npm run build
Uploaded images 404Storage not linked → php artisan storage:link
Uploads rejectedPHP fileinfo extension missing → install/enable it
Emails & campaigns not sendingQueue worker not running → check Supervisor: sudo supervisorctl status
Scheduled campaigns never go outCron entry missing → add the schedule:run line
Payments succeed but orders stay pendingWebhook not registered with the gateway → register the URLs from deploy/DEPLOYMENT.md
Changes to .env have no effectConfig cached → php artisan config:cache
Wrong customer IPs / mixed-content behind CloudflareTrusted proxies not set → see deploy/DEPLOYMENT.md § proxies
AI features show "not configured"No provider key saved → add keys under Admin → Settings → AI
Locked out of adminphp artisan storemine:admin-password <email> prints a fresh password

Reading the logs

php artisan pail                       # live, pretty
tail -f storage/logs/laravel.log       # classic

Still stuck?

Collect these before asking for support — they answer 90% of questions up front:

  1. Output of php artisan storemine:preflight
  2. PHP version (php -v) and the last 50 lines of storage/logs/laravel.log
  3. What you changed most recently