Common Errors & Troubleshooting

Encountered an unexpected error message or behavior? Browse our curated list of common installation and operational exceptions along with their verified technical resolutions.

HTTP 500 — Internal Server Error

Likely Cause: Incorrect database configuration in `.env` or improper storage directory permissions (`storage/` directory not writable).

Recommended Resolution:

Verify that all `DB_*` variables in `.env` match your database connection parameters exactly. Run `chmod -R 775 storage bootstrap/cache` via SSH or check directory write permissions in your cPanel/DigitalOcean dashboard.

cURL error 60: SSL certificate problem

Likely Cause: Outdated or missing `cacert.pem` SSL bundle in your PHP environment during automated game API checks or gateway communications.

Recommended Resolution:

Download the latest `cacert.pem` from curl.haxx.se, place it in your PHP directory, and update your `php.ini` file with: `curl.cainfo = "/path/to/cacert.pem"` and `openssl.cafile = "/path/to/cacert.pem"`.

API Gateway Top-up Stuck in 'Pending' State

Likely Cause: Cron job schedule is not running or callback webhook URL is blocked by Cloudflare/WAF.

Recommended Resolution:

Ensure `php artisan schedule:run` is configured as a minute-by-minute cron job. Whitelist the API gateway provider IP addresses in your firewall or Cloudflare configuration.

SQLSTATE[42S02]: Base table or view not found

Likely Cause: Migrations were not run after uploading new version code.

Recommended Resolution:

Run `php artisan migrate --force` via terminal or execute the database upgrade routine from your Admin Panel → System Maintenance settings.