Troubleshooting

Solutions to common problems you may encounter when running Plainpad.

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 7.4 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 Plainpad 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 plainpad_db

URL Rewriting Not Working

If you get 404 errors when navigating Plainpad:

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

Notes Not Saving

If notes fail to save:

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

Offline Mode Not Working

Plainpad's PWA (offline) features require:

  • HTTPS — Service workers only function over secure connections
  • Modern Browser — Use a recent version of Chrome, Firefox, Edge, or Safari
  • Clear your browser's service worker cache if experiencing stale content

Performance Issues

If Plainpad feels slow:

  • Enable PHP OPcache for faster script execution
  • Ensure your database server has adequate resources
  • Consider switching from SQLite to MySQL for larger installations
  • Check server resource usage (top, htop)

Still Need Help?

If the above solutions don't resolve your issue: