Troubleshooting

Common issues + fixes. Always check kode/storage/logs/laravel.log for the actual error before doing anything else.

Where to find errors

tail -f /home/user/public_html/kode/storage/logs/laravel.log

Or via cPanel File Manager → navigate to kode/storage/logs/ → open latest laravel.log.

Installation issues

500 error during install

File permissions wrong. Run:

chmod -R 755 .
chmod -R 775 kode/storage kode/bootstrap/cache

"Specified key was too long"

MySQL too old. Upgrade to 8.0+ or MariaDB 10.6+.

White page

Enable debug mode temporarily in kode/.env:

APP_DEBUG=true

Reload page to see actual error. Set back to false after.

Installer keeps redirecting

rm kode/storage/cartuser_installed
php artisan cache:clear

Update issues

Update tool fails mid-process

Check laravel.log for actual error. Common causes:

• Insufficient disk space → clear old backups
• Permission denied → chmod -R 775 kode/storage
• Memory limit → increase memory_limit = 512M in php.ini
• Max execution time → increase to 600

"Update package contains sensitive files"

Your ZIP includes .env or .htaccess — security guard rejected it. Re-package without those files.

Missing columns after update

php artisan schema:fix
php artisan migrate --force
php artisan optimize:clear

Frontend issues

"Class not found" / autoloader errors

cd /home/user/public_html/kode
composer dump-autoload --no-dev --optimize
php artisan optimize:clear

Home page blank or shows old content

php artisan cache:clear
php artisan view:clear

Images not loading

• Check kode/.env: APP_URL=https://yourdomain.com (no trailing slash, correct protocol)
• Verify storage symlink: php artisan storage:link
• Check folder permissions: chmod -R 775 assets/images/

"Mixed content" errors (HTTP/HTTPS)

Set in kode/app/Providers/AppServiceProvider.php:

if (env('APP_ENV') === 'production') {
    URL::forceScheme('https');
}

Admin / login issues

Login redirects to "Unauthorized"

Roles table empty (seeder didn't run). Run:

php artisan db:seed --class="Database\Seeders\Installer\RoleSeeder" --force
php artisan cache:clear

Forgot SuperAdmin password

php artisan tinker --execute="
\$a = App\Models\Admin::where('user_name','admin')->first();
\$a->password = bcrypt('newpassword');
\$a->save();
"

Order & payment issues

Payment shows "Failed" but customer was charged

Callback URL not set in gateway dashboard. Open gateway edit page in admin → copy Callback URL → paste into gateway provider's webhook config.

Cart total doesn't match

Currency conversion issue. Verify:

• Admin → Settings → Currency → default currency set correctly
• Exchange rates up to date
• Order's currency_id matches at checkout time

Checkout 500 error

Likely missing column. Run:

php artisan schema:fix
php artisan cache:clear

Email issues

Emails not sending

1. Verify SMTP credentials in .env
2. Test: php artisan tinker --execute="Mail::raw('test', fn(\$m) => \$m->to('[email protected]')->subject('test'));"
3. Check failed jobs: php artisan queue:failed
4. Retry: php artisan queue:retry all

Gmail SMTP rejected

Gmail requires app-specific password if 2FA is on. Create one at myaccount.google.com/apppasswords.

SMS issues

OTP not arriving

1. Verify SMS gateway credentials
2. Check SMS provider credit balance
3. Test from Admin → Settings → SMS → Send Test SMS
4. Some providers reject without sender ID approval

Mobile app issues

App shows "Cannot connect to server"

• Verify backend URL uses HTTPS
• Test API: curl https://yourdomain.com/api/config
• Check SSL certificate validity
• iOS rejects self-signed certs — use Let's Encrypt or commercial SSL

App shows old data

• Clear app cache from device settings
• Verify server cache cleared: php artisan cache:clear

Push notifications not arriving

• Verify FCM Server Key in Admin → Settings → Push Notification
• Check Firebase project matches the one in app's google-services.json
• Test from Firebase console first

Performance issues

Slow page loads

1. Enable OPcache (PHP performance boost)
2. Switch to Redis cache: CACHE_DRIVER=redis in .env
3. Run php artisan optimize
4. Use CDN for static assets (CloudFlare, BunnyCDN)
5. Optimize images (compress, WebP format)

Database slow queries

• Check MySQL slow query log
• Add indexes on frequently filtered columns
• Use MySQL 8.0+ for better query optimizer
• Run php artisan db:optimize

Common error messages

Still stuck?

• Read kode/storage/logs/laravel.log bottom 50 lines
• Contact CodeCanyon support via your purchase page
• Provide: PHP version, MySQL version, exact error from log, steps to reproduce