# Troubleshooting Common issues and their solutions. ## Table of Contents - [Installation Issues](#installation-issues) - [Database Issues](#database-issues) - [Authentication Issues](#authentication-issues) - [Display Issues](#display-issues) - [Email Issues](#email-issues) - [Performance Issues](#performance-issues) - [Docker Issues](#docker-issues) - [Diagnostic Steps](#diagnostic-steps) ## Installation Issues ### Wizard does not load **Symptom:** Accessing WebCalendar shows a blank page or error instead of the installation wizard. **Solutions:** 1. Verify PHP is working: create a `phpinfo.php` with ` Security Audit > Diagnostic report**. The individual checks below are still useful when you want to look at one thing in isolation, or when you cannot run the command at all. ### Check PHP configuration ```bash php -v # PHP version php -m # Loaded extensions php -i | grep -i timezone # Timezone setting ``` ### Check file permissions ```bash ls -la includes/settings.php ls -la includes/ ``` ### Check database connectivity ```bash # MySQL mysql -u webcalendar -p -h localhost webcalendar -e "SELECT 1" # PostgreSQL psql -U webcalendar -h localhost webcalendar -c "SELECT 1" ``` ### Check error logs ```bash # Apache tail -f /var/log/apache2/error.log # Nginx + PHP-FPM tail -f /var/log/nginx/error.log tail -f /var/log/php-fpm/error.log # Docker docker-compose logs -f ``` ### Run PHP syntax check ```bash cd /path/to/webcalendar tests/compile_test.sh ```