Troubleshooting & Debugging Caddy

Top three most common issues:

  • Outdated software on your site
  • Conflict with your theme
  • Conflict with another plugin

For troubleshooting, please try to follow these steps:

Important: You should make a complete backup of your before trying any of the below suggestions.

  • Make sure your server’s PHP version is above 5.4, although above 7.0 is ideal.
  • Make sure you are using the most updated versions of Caddy, WordPress & your theme.
  • Deactivate all your plugins besides Caddy (and Caddy Premium). If this solves the problem, gradually activate your plugins one by one, until you spot the problematic plugin.
  • If you have a caching plugin, make sure you deactivate it, or even better – purge the cache.
  • Change your WordPress theme (temporarily) to WordPress Twenty Twenty (or other default WordPress theme).
  • Check Chrome developer tools for any errors in the browser.
  • Check your WordPress debug.log for any errors related to Caddy.

CSS/JS minification plugins

If you’re running a CSS/JS minification plugin such as WP Rocket or Siteground Optimizer, sometimes these plugins can cause issues loading Caddy’s JS or CSS files. You can try excluding Caddy’s CSS and/or JS files.

For WP Rocket specifically, you can try to add the following

/wp-content/plugins/caddy/public/css/(.*).css

Under:

If you have followed all these steps and you’re still encountering difficulties, please contact us following these steps:

  • Describe the issue and what led to it.
  • Please be as accurate and detailed as possible.
  • If you suspect the issue was caused by the theme or plugin you are using, please attach the name + URL of the theme/plugin.