Common Troubleshooting

Getting Started

Clear browser cache, check browser console for errors, try a different browser, and note the exact error message. Application logs are typically in logs/ or storage/logs/ directory.

Installation Issues

500 Internal Server Error: Check file permissions (chmod -R 775 storage cache logs), verify configuration file exists with valid settings, and review error logs.

Database Connection: Verify credentials in configuration file, ensure user has proper privileges, check DB_HOST (may be localhost or IP address), and confirm database exists.

404 Not Found: Verify mod_rewrite is enabled, check .htaccess is present (for Apache), ensure virtual host points to correct directory, and clear browser cache.

Runtime Issues

Scheduled Tasks Not Running: Verify cron job runs every minute, test the scheduled task script manually, and review scheduler logs.

Email Not Sending: Verify mail configuration in configuration file, check credentials, test email functionality using a test script, review mail logs, and check spam folder.

File Uploads Failing: Check PHP upload settings (upload_max_filesize, post_max_size), verify storage permissions (775), and ensure upload directory exists and is writable.

Session/Login Issues: Clear browser cookies and cache, check session configuration in configuration file, verify sessions directory is writable, and try incognito mode.

Performance

Slow Page Loads: Enable application caching (check application documentation), check database queries, verify OPcache is enabled, and optimize images.

High Memory Usage: Increase PHP memory limit in php.ini, optimize database queries, clear old logs and cache, and check for memory leaks.

Background Jobs Stuck: Verify background job processor is running, check queue configuration in configuration file, start the worker process, and configure Supervisor or similar for production.

Security

Mixed Content Warnings: Ensure SSL certificate is installed, force HTTPS, and update HTTP URLs to HTTPS.

Permission Denied: Check file and directory permissions, verify ownership, ensure configuration file is not publicly accessible, and review web server configuration.

Getting Help

Check logs, search error messages online, review documentation, and submit support tickets with error details, reproduction steps, screenshots, and environment information.