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.


Install WHMCS

The first step to using WHMCS is installing it on your server. WHMCS includes an easy browser installation tool to suit most users' needs.


Troubleshooting Installation

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




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.


System Requirements

For successful installation, updates, and operation, your system must meet the minimum system requirements for your WHMCS version.


Updating WHMCS

You can check for updates and apply them directly 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 production server.


System Health

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




Check for Updates

WHMCS automatically checks for new updates daily. You can also check for updates to WHMCS manually from within the Admin Area.


Optimize Performance

As your database size increases, you may experience slower page loads and other speed-related issues. Optimizing your database and reducing unnecessary data can help WHMCS run faster.