The System Health page provides an overview of the WHMCS installation and system environment status. It will highlight any potential configuration or security related issues that may need your attention. It also allows you to check if any updates are available for your currently installed WHMCS version, as well as providing quick and easy access to the change log and release notes for it.
You can find this feature at Configuration () > System Health.
Your system does not currently meet all of the requirements to use the Automatic Updater feature at Utilities > Update WHMCS.
Check your configuration to make certain that you meet all of the requirements for automatic updates. You may need to reconfigure your temporary path to ensure that the system can write to your update file staging directory.
Certificate Authority Verified SSL Not Detected on this Server #
Item Type
Description
Recommended Solution
Warning
This warning indicates that a cURL call check of the WHMCS domain’s SSL certificate did not return the correct response. The system runs the curl -I https://example.com command, where https://example.com is your domain, in order to check this. It returns an error if it does not receive a 200 response code.
Check your domain’s SSL certificate and troubleshoot the error.
This check indicates whether WHMCS detected that you are using CloudFlare. A warning displays if there is a misconfiguration in your settings for trusted proxies.
Click the link in the displayed warning message to automatically adjust your trusted proxy settings.
For CloudLinux™ users, this warning indicates that WHMCS detected the pdo_mysql PHP extension. This extension can cause display issues and other problems within WHMCS.
Use the PHP Selector feature at CloudLinux PHP Configuration in the CloudLinux control panel to enable the nd_pdo_mysql PHP extension instead. The System Health warning will disappear immediately.
This warning indicates that PHP is executing automation tasks using a different timezone from the PHP version that you use when visiting the Admin Area using a browser.
Some server configurations use separate php.ini configurations for the command line or cron engine and the web server. This can cause problems for WHMCS.
Make certain that the web server and command line use the same timezone.
This warning indicates that PHP is executing automation tasks under a different PHP version from the PHP version that you use when visiting the Admin Area using a browser.
Some server configurations use separate php.ini configurations for the command line or cron engine and the web server. This can cause problems for WHMCS.
Make certain that the web server and command line use the same PHP version.
The warning may not disappear immediately after making the necessary changes to resolve the issue. The system caches the result of this check and only updates it after the daily cron tasks execute.
This attention item indicates that there are default directory paths that you have not yet customized. We recommend that you customize several WHMCS directory paths for increased security.
This warning lists the names of any default system theme or order form template names that the system currently uses.
If you have not customized any themes or templates, you can safely ignore this warning.
If you have made customizations, make certain that you make your changes in a uniquely-named copy of the theme or template within a separate directory. Do not update the default template files or store custom files in the default template or theme directories.
This check warns you if you have enabled Display Errors in the Other at Configuration () > System Settings > General Settings.
Disable this setting unless you are actively troubleshooting an issue. We also recommend adding the following error_reporting setting to your server’s PHP configuration: E_ALL & ~E_WARNING & ~E_USER_WARNING & ~E_NOTICE & ~E_USER_NOTICE & ~E_STRICT & ~E_DEPRECATED & ~E_USER_DEPRECATED
The system detected an issue in the proper execution of event handling jobs like the Create, Terminate, and other actions for WHMCS’s provisioning modules.
Consider changing the Event Handling setting in the Other tab at Configuration () > System Settings > General Settings.
This warning indicates that the MySQL server’s configuration may not allow connections to remain open long enough during certain WHMCS tasks. WHMCS requires access to the database in order to function, including sustained connections during some long-running database operations. A warning appears if any of the following settings are below the required minimums:
connect_timeout is below 10.
wait_timeout is below 300.
interactive_timeout is below 300.
max_allowed_packed is below 4194304 (4 MB).
Adjust your MySQL configuration to include the values that this warning lists.
This warning indicates that the OPcache PHP extension is enabled. This extension can cause serious problems with cached data use and PHP script execution in WHMCS.
These checks display common issues with your PHP environment’s session configuration.
Item Type
Description
Recommended Solution
Needing Attention
Session autostart is enabled You have enabled session.auto_start in your PHP configuration (session.auto_start=On). WHMCS requires that you disable this setting in order to retain admin and user login sessions.
Change the session.auto_start setting to Off in your PHP configuration.
Needing Attention
PHP session support is disabled You have disabled PHP session support in your PHP configuration using the --disable-session option, or other technical issues are preventing PHP from handling sessions correctly.
Reenable session support and ensure that no other issues are preventing sessions.
Needing Attention
The PHP Session save path is not writeable The system cannot write to the path that you specified as the session.save_path value in your php.ini configuration. This check uses the PHP is_writeable function to determine this.
Check to ensure that the path is a valid full path and uses the correct file permissions.
Warning
Support Ticket Mask Check The system has used 51% to 85% of the number of possible ticket number combinations that your Support Ticket Mask Format setting allows in the Support tab at Configuration () > System Settings > General Settings.
Reconfigure your Support Ticket Mask Format setting to allow a higher possible number of ticket number combinations.
Needing Attention
Support Ticket Mask Check The system has used 85% or more of the number of possible ticket number combinations that your Support Ticket Mask Format setting allows in the Support tab at Configuration () > System Settings > General Settings.
Reconfigure your Support Ticket Mask Format setting to allow a higher possible number of ticket number combinations.
This check displays issues with running the /crons/pop.php script in the last hour for a configured support department. If this script does not run successfully, the system cannot import email from the POP3 mail server into the WHMCS support ticket system.
Configure a cron job to run the /crons/pop.php script at five-minute intervals. You can find a sample cron command at Configuration () > System Settings > Support Departments.
This check displays any daily automation tasks that the system cron did not perform in the past 24 hours. Failures may indicate that the cron job is not running due to an invalid cron command, incorrect file permissions, or other issues.
Check to ensure that your system cron is properly configured and running on the correct schedule.
This item indicates that you have not properly set the WHMCS System URL value in the General tab at Configuration () > System Settings > General Settings. If possible, WHMCS attempts to set this value automatically during installation.
