POP3 Cron Not Running


Full Administrators receive a warning email indicating that POP3 details exist for a support department but the required cron job is not configured to import the emails.


You may receive this email if the cron job could not run successfully or if it does not exist.


To troubleshoot this issue, ensure that the cron job is configured. If that is not the issue, you will need to ensure that the cron job can finish successfully.

Check for Cron Job Configuration

To complete cron configuration:

  1. Go to Configuration () > System Settings > Support Departments.
  2. Copy the cron job command for pop.php at the top of the page.
  3. Log in to your server and create a new cron job to execute the pop.php script every five minutes.
For more information, see Email Piping.

Ensure Completion

If a cron job for the pop.php script is already configured, the email indicates that an error is preventing the script from completing. Check the Ticket Mail Import Log at Configuration () > System Logs for more information about the error and to determine next steps.

You can also find error details by temporarily adding the following line to the configuration.php file and then visiting http://www.example.com/crons/pop.php, where www.example.com is your WHMCS installation’s location:

$pop_cron_debug = true;
For more information about updating the configuration.php file, see The configuration.php File.


You can also resolve this error by disabling email importing.

To do this:

  1. Configuration () > System Settings > Support Departments.
  2. Edit a department.
  3. Clear the POP3 Importing Configuration settings.
  4. Click Save Changes.
  5. Repeat the process for each support department.

WHMCS will no longer attempt to import emails from the inbox.

Last modified: June 11, 2024