Common Issues

Overview

This article covers the most common issues encountered when using Flint Engine and their solutions. If you cannot find your issue here, check the specific troubleshooting articles for installation, payment, or order issues.

Settings Not Updating

Symptom: You changed a setting but the frontend still shows the old value.

Solution: Clear the cache.

• Go to System → Cache → Clear Cache
• Or run php artisan cache:clear from the command line
• Settings are cached for performance and must be cleared after changes

Emails Not Sending

Symptom: Order confirmation emails or support replies are not delivered.

Solution: Verify SMTP configuration.

• Go to Settings → Email and check SMTP credentials
• Check that mail_host, mail_port, mail_username, mail_password are correct
• Test the connection in System → Mail Profiles
• Check the PHP error log for mail-related errors
• Verify that your server allows outbound SMTP connections

License Activation Fails

Symptom: Customers report that license activation returns an error.

Solution: Check the license and activation status.

• Go to Products → Licenses and verify the license is active
• Check the activation count vs. maximum allowed
• Verify the product associated with the license exists
• Check the API endpoint is accessible: /api/license/verify
• Review server error logs for API-related issues

Admin Panel Shows Blank Page

Symptom: The admin panel loads but shows a blank white page.

Solution: Enable debug mode to see the error.

• Set APP_DEBUG=true in the .env file
• Reload the page to see the actual error message
• Check PHP error logs for fatal errors
• Verify file permissions on the storage directory
• After fixing, set APP_DEBUG=false in production

Images Not Uploading

Symptom: File uploads fail or images do not appear after upload.

Solution: Check upload permissions and limits.

• Verify the storage/uploads/ directory is writable
• Check PHP upload_max_filesize and post_max_size settings
• Verify the gd or imagick PHP extension is installed
• Check disk space on the server

Slow Performance

Symptom: Pages load slowly, especially with many products or orders.

Solution: Optimize caching and database.

• Enable Redis caching (recommended for production)
• Run php artisan config:cache and php artisan route:cache
• Enable OPcache in PHP
• Optimize database tables
• Review and optimize slow database queries

Permission Errors

Symptom: Users cannot access certain admin features.

Solution: Check user role and module access.

• Go to Users and verify the user's role
• Go to Roles and check module access for that role
• Ensure the role has access to the required modules
• Assign a role with broader access if needed

Related Articles

• Installation Issues — Problems during installation
• Payment Issues — Payment processing problems
• Order Issues — Order management problems