How to troubleshoot WP Toolkit

Question

How do you troubleshoot issues with the WP Toolkit?

Answer

If WP Toolkit shows errors on the screen or otherwise seems to be encountering an issue, reviewing the error logs can help to identify the problem.

The log files for WP Toolkit reside in the /usr/local/cpanel/3rdparty/wp-toolkit/var/logs/ directory.

To troubleshoot WP Toolkit, run the following command:

# grep -A2 ERROR /usr/local/cpanel/3rdparty/wp-toolkit/var/logs/main-YYYY-MM-DD.log

Note: "YYYY-MM-DD" must be replaced with the log file's date in year-month-day format. 

You can also enable enhanced logging to debug and troubleshoot WP Toolkit. To do this, add the following line to the /usr/local/cpanel/3rdparty/wp-toolkit/var/etc/config.ini file:

CONFIG_TEXT: logCommandsAndFileOperations = true

Warning: We strongly recommend that you only enable enhanced logging when you need to troubleshoot the WP Toolkit. Enhanced logging may significantly slow down the WP Toolkit’s performance, and the WP Toolkit log file sizes will also increase. Be sure to disable the enhanced logging after you finish troubleshooting.

Additional Resources

WP Toolkit (cPanel Docs)