Debugging and Troubleshooting

Common issues, debug tools, and how to resolve problems with RakuWP.

Enable WordPress Debug Mode

To see detailed error messages, enable debug mode in your wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Errors will be logged to wp-content/debug.log instead of being displayed to visitors.

Common Issues

License validation fails

  • Firewall blocking requests: Ensure your server allows outbound HTTPS connections to the RakuWP panel domain. Some security plugins (Wordfence, Sucuri) or server firewalls may block these.
  • SSL certificate issues: Make sure your server has up-to-date CA certificates. Run curl https://panel.rakuwp.com from your server to test.
  • Incorrect license key: Copy the key directly from the panel to avoid invisible characters.

Services not loading

  • Services are disabled: Check the panel to ensure the service is enabled for your site.
  • PHP version too old: Some services require PHP 8.1+. Check your PHP version in the site detail page on the panel.
  • Plugin conflicts: Temporarily deactivate other plugins to test for conflicts.

Plugin update not showing

  • WordPress caches update checks. Go to Dashboard → Updates and click Check Again.
  • Verify your license is active — expired licenses may not receive update notifications.

Getting Help

If you cannot resolve an issue, open a Support Ticket from the panel. Include:

  • Your WordPress version and PHP version
  • The RakuWP plugin version
  • Any error messages from debug.log
  • Steps to reproduce the problem
Previous Hooks and Filters