Troubleshooting

AI jobs stuck on queued

Cause: queue worker not running.

Fix:

• Set QUEUE_CONNECTION=database or redis
• Run php artisan migrate if you use the database queue (needs a jobs table)
• Start a worker: php artisan queue:work (dev) or use Supervisor on Linux production — see Admin Setup → Queue worker

"Insufficient credits"

Cause: user wallet balance is too low.

Fix:

• Purchase credits
• Or increase credits in admin

Payment verified but credits missing

Cause: webhook or callback not configured.

Fix:

• Ensure gateway webhooks are enabled
• Re-try the payment verification from the UI

Background removal error about public URL

Cause: the image URL is not publicly accessible.

Fix:

• Use S3/Wasabi/DO storage
• Or make sure your domain is public

Email not sending

Cause: SMTP details or mail driver not set.

Fix:

• Check email settings in admin
• Send a test email

Installer page shows blank or error

Fix:

• Check PHP version and extensions
• Ensure write permissions
• Clear cache and retry