How to Setup WHMCS Cron Jobs Correctly

Why Cron Jobs Are Important

Cron jobs are considered the backbone of WHMCS automation.

If your cron job stops working, many important business operations can be affected.

Benefits of WHMCS Cron Jobs

Automated Invoice Generation

WHMCS automatically creates invoices before service due dates.

Automated Payment Reminders

Customers receive reminders before invoices become overdue.

Automatic Account Suspension

Unpaid hosting accounts can be suspended automatically according to your billing policy.

Automatic Account Reactivation

Once payment is received, suspended services can be reactivated automatically.

Domain Renewal Automation

WHMCS automatically handles domain renewal notices and processing.

Reduced Administrative Work

Cron automation eliminates repetitive manual tasks and allows hosting providers to focus on growing their business.

Improved Customer Experience

Customers receive timely notifications and faster service provisioning.

Locate the Cron Command in WHMCS

Before configuring a cron job, you need to obtain the correct cron command from WHMCS.

Modern WHMCS versions provide a recommended cron command within the administration area.

Step 1: Login to WHMCS Admin Area

Access your WHMCS administrator dashboard.

Example:

https://yourdomain.com/admin

Step 2: Navigate to System Health Status

Go to:

Utilities → System → System Health Status

Step 3: Locate Cron Configuration

Under the Cron Status section, WHMCS will display the recommended cron command.

Example:

/usr/local/bin/php -q /home/username/public_html/crons/cron.php

Your actual path may vary depending on your server configuration.

Always use the command generated by WHMCS rather than creating one manually.

Setup WHMCS Cron Job in cPanel

Most shared hosting and reseller hosting users manage cron jobs through cPanel.

If your WHMCS installation is hosted on a cPanel server, follow these steps.

Step 1: Login to cPanel

Access your hosting account’s cPanel dashboard.

Step 2: Open Cron Jobs

Navigate to:

Advanced → Cron Jobs

Step 3: Create a New Cron Job

You will see a form allowing you to schedule tasks.

Step 4: Configure Cron Frequency

WHMCS recommends running the cron job once every 5 minutes.

Example configuration:

Minute: */5

Hour: *

Day: *

Month: *

Weekday: *

This schedule executes the cron task every five minutes.

Step 5: Enter WHMCS Cron Command

Paste the cron command copied from the WHMCS System Health Status page.

Example:

/usr/local/bin/php -q /home/username/public_html/crons/cron.php

Step 6: Save Cron Job

Click:

Add New Cron Job

Your WHMCS cron job is now configured.

Setup WHMCS Cron Job on Linux VPS

Users running WHMCS on VPS Hosting or Dedicated Servers often configure cron jobs directly through SSH.

Step 1: Login via SSH

Connect to your server as root or a privileged user.

Example:

ssh root@your-server-ip

Step 2: Open Crontab Editor

Execute:

crontab -e

Step 3: Add WHMCS Cron Entry

Insert the following line:

*/5 * * * * /usr/local/bin/php -q /home/username/public_html/crons/cron.php

Replace the path with your actual WHMCS cron command.

Step 4: Save Configuration

Save and exit the editor.

The cron service will automatically reload the configuration.

Step 5: Verify Cron Installation

Run:

crontab -l

You should see the newly added WHMCS cron job.

Test WHMCS Cron Functionality

After configuring the cron job, it is important to verify that it is working correctly.

Method 1: System Health Status

Navigate to:

Utilities → System → System Health Status

Look for:

Last Cron Run

If the timestamp updates regularly, the cron job is functioning properly.

Method 2: Run Cron Manually

Access SSH and execute:

php cron.php

The command should complete without errors.

Method 3: Review Automation Logs

Navigate to:

Utilities → Logs → Activity Log

Look for cron execution entries.

Method 4: Review Email Notifications

WHMCS sends daily automation reports.

Verify that these reports are being received successfully.

Common WHMCS Cron Errors

Even when configured correctly, WHMCS cron jobs may occasionally encounter issues.

Error 1: Cron Not Running

Symptoms

• No invoices generated
• No automation activity
• No renewal reminders

Possible Causes

• Incorrect cron command
• Disabled cron service
• Permission issues

Solution

Verify cron path and confirm cron service is active.

Error 2: PHP Version Mismatch

Symptoms

PHP Fatal Error

Cause

Unsupported PHP version.

Solution

Use a WHMCS-supported PHP version.

Error 3: Permission Denied

Symptoms

Permission Denied

Cause

Incorrect file permissions.

Solution

Verify ownership and permissions of:

• cron.php
• WHMCS directories

Error 4: Memory Limit Exceeded

Symptoms

Allowed Memory Size Exhausted

Cause

Insufficient PHP memory allocation.

Solution

Increase:

memory_limit = 512M

or higher if required.

Error 5: Automation Tasks Incomplete

Symptoms

Some automation tasks execute while others fail.

Cause

Cron timeout or server resource limitations.

Solution

Monitor:

• CPU usage
• RAM usage
• Disk performance