Troubleshooting

Solutions to common problems you may encounter when running Clientverse.

Blank Page / 500 Error

If you see a blank page or a 500 Internal Server Error, check the following:

  • PHP Error Logs — Check your server's PHP error log for detailed error messages. On most servers this is located at /var/log/php/error.log or /var/log/apache2/error.log.
  • File Permissions — Ensure the web server can read all files and write to the necessary directories.
  • PHP Version — Verify that PHP 8.0 or newer is installed: php -v
  • Required Extensions — Check that all required PHP extensions are enabled.
# Check installed PHP extensions
php -m | grep -E 'mbstring|pdo|json|openssl'

Database Connection Failed

If Clientverse cannot connect to the database:

  • Verify that your database credentials in the configuration file are correct
  • Ensure the database server is running
  • Check that the database user has sufficient privileges
  • If using MySQL, verify the host and port are correct
# Test MySQL connection
mysql -u username -p -h localhost clientverse_db

URL Rewriting Not Working

If you get 404 errors when navigating Clientverse:

Apache

  • Ensure mod_rewrite is enabled: sudo a2enmod rewrite
  • Verify AllowOverride All is set in your virtual host configuration
  • Restart Apache after changes: sudo systemctl restart apache2

Nginx

  • Ensure your try_files directive is configured correctly
  • Reload Nginx after changes: sudo systemctl reload nginx

Data Not Saving

If data fails to save:

  • Check that the database is accessible and has sufficient disk space
  • Check browser console for JavaScript errors
  • Ensure you haven't exceeded any PHP upload or post size limits

HTTPS Issues

Clientverse should be served over HTTPS for security. If you experience issues:

  • HTTPS — Ensure your SSL certificate is valid and properly configured
  • Modern Browser — Use a recent version of Chrome, Firefox, Edge, or Safari
  • Clear your browser cache if experiencing stale content after updates

Performance Issues

If Clientverse feels slow:

  • Enable PHP OPcache for faster script execution
  • Ensure your database server has adequate resources
  • Ensure MySQL is properly configured and optimized for your workload
  • Check server resource usage (top, htop)

Still Need Help?

If the above solutions don't resolve your issue: