General Troubleshooting

General errors can occur in many places throughout WHMCS, and can be due to many different problems. However, fixing them is often simple.

System Requirements

For successful operation of and updates to of self-hosted WHMCS installations, your system must meet the minimum system requirements for your WHMCS version.

Troubleshooting Installation

When you install WHMCS on a server, make sure to watch for errors both during and after the installation process.


Install WHMCS

The first step to running a self-hosted WHMCS installation is installing it on your server. WHMCS includes an easy browser installation tool to suit most users' needs.

Install on the Command Line

If you want more configuration options than browser-based installation offers, you can install and upgrade WHMCS on the command line.

Updating WHMCS

You can check for updates and apply them directly to your self-hosted WHMCS installation in the Admin Area using the automatic updater.

Set Up a Test Environment

To prevent problems, we recommend testing updates and customizations in a test environment before applying them to your self-hosted WHMCS installation.

System Health

Use System Health to view your system environment status and quickly find and address issues.


Check for Updates

Self-hosted WHMCS installations automatically check for new updates daily. You can also check for updates to WHMCS manually from within the Admin Area.

Optimize Performance

Optimizing your WHMCS configuration can prevent performance-related issues in WHMCS. Performance issues can occur due to many factors, including insufficient system resources, large databases, problematic modules, or server configuration issues.

Prepare to Update WHMCS

Before you update your self-hosted WHMCS installation, we recommend several preparatory steps.