System Health

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 Changelog and Release Notes for it.

System Health

You can find this feature at Configuration () > System Health.

System Health Checks

For help making any necessary system configuration changes, contact your hosting provider or system administrator.

The list includes information about the following checks:

Automatic Update Requirements

Item TypeDescriptionRecommended Solution
WarningYour 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.
For more information, see Updating WHMCS.

Certificate Authority Verified SSL Not Detected on this Server

Item TypeDescriptionRecommended Solution
WarningThis 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.

CloudFlare® Proxy Check

We added this check in WHMCS 8.10.
Item TypeDescriptionRecommended Solution
WarningThis 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 more information, see CloudFlare Proxy Check Errors.

CloudLinux MySQL Extension Check

Item TypeDescriptionRecommended Solution
WarningFor 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.

Cron PHP Timezone

Item TypeDescriptionRecommended Solution
WarningThis 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.
For more information, see System Timezone Issues.

Cron PHP Version Mismatch

Item TypeDescriptionRecommended Solution
WarningThis 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.
For more information, see Resolve a Cron PHP Mismatch.
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.

cURL/TLS/OpenSSL Version Warnings

Item TypeDescriptionRecommended Solution
WarningThe system did not detect the required versions of cURL (7.36.0), TLS (1.1 or 1.2), or OpenSSL (1.0.1c).Update the necessary items on your system to meet our requirements.

Customising Default Paths

Item TypeDescriptionRecommended Solution
Needing AttentionThis 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.Perform the recommended customizations.

Custom Templates

Item TypeDescriptionRecommended Solution
WarningThis 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.

Error Reporting

Item TypeDescriptionRecommended Solution
Needing AttentionThis 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

Event Handling

We added this check in WHMCS 8.4.
Item TypeDescriptionRecommended Solution
Needing AttentionThe 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.

MySQL Server Configuration Check

We added this check in WHMCS 8.1.
Item TypeDescriptionRecommended Solution
WarningThis 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.

Permissions Check

Item TypeDescriptionRecommended Solution
Needing AttentionInsecure Permissions Check
This check ensures that WHMCS files and directories have the appropriate permissions.
Make certain that all of the files and directories in your WHMCS installation use the correct permissions.
For more information, see Permissions.

PHP Error Levels

Item TypeDescriptionRecommended Solution
Needing AttentionThis check indicates that the error reporting level for PHP is set to a very high setting. We recommend only logging certain error types.Reduce the error reporting level for PHP.

PHP Memory Limit

Item TypeDescriptionRecommended Solution
WarningThe memory limit setting for your PHP environment is below the recommended value.Increase the PHP memory limit in your configuration.
Needing AttentionThe memory limit setting for your PHP environment is below the minimum value.Increase the PHP memory limit in your configuration.

PHP Session Support

These checks display common issues with your PHP environment’s session configuration.

Item TypeDescriptionRecommended Solution
Needing AttentionSession 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 AttentionPHP 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 AttentionThe 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.
WarningSupport 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 AttentionSupport 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.

PHP Version

Item TypeDescriptionRecommended Solution
WarningYour current PHP version is not compatible with the system requirements for your current version of WHMCS.Make certain that you are running a compatible version of PHP.
For more information, see Upgrade PHP.

POP Cron Ticket Import

Item TypeDescriptionRecommended Solution
Needing AttentionThis 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.
Item TypeDescriptionRecommended Solution
WarningThis check lists any missing items from WHMCS’s list of recommended PHP extensions.Add the missing extensions to your PHP configuration and then recompile PHP.

Required PHP Extensions

Item TypeDescriptionRecommended Solution
Needing AttentionThis check lists any missing items from WHMCS’s list of required PHP extensions.Add the missing extensions to your PHP configuration and then recompile PHP.

Required PHP Functions

Item TypeDescriptionRecommended Solution
Needing AttentionThis check lists any missing items from WHMCS’s list of required PHP functions.Check for the missing functions in your php.ini configuration’s disable_functions setting and remove them.

Secure TLS Support in cURL

Item TypeDescriptionRecommended Solution
Needing AttentionThis check indicates whether the curl library in your PHP configuration has the required secure TLS (TLS 1.1 and 1.2) support.Make certain that your curl library includes SSL.

SSL Support in cURL

Item TypeDescriptionRecommended Solution
Needing AttentionThis check indicates whether the curl library in your PHP configuration has the required SSL support.Make certain that your curl library includes SSL.

System Cron Tasks

Item TypeDescriptionRecommended Solution
Needing AttentionThis 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.
For more information, see Check the Cron Job Status.

System URL Check

We added this check in WHMCS 8.8.
Item TypeDescriptionRecommended Solution
Needing AttentionThis 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.Configure the WHMCS System URL setting.

Website SSL

Item TypeDescriptionRecommended Solution
WarningThis check indicates that WHMCS is not using an SSL certificate and the System URL setting does not use the https:// protocol.Install an SSL certificate for your website and update the System URL setting in the General at Configuration () > System Settings > General Settings.
For more information, see Update the System URL.

Last modified: April 30, 2024