Our documentation is getting an overhaul! We would like your input! Click here to take a look at the beta launch of our new documentation site! Only cPanel & WHM version 82 documentation exists on our beta at this time. 84 will be added to the new site soon! Leave your feedback here: https://go.cpanel.net/docsfeedback
The manage_greylisting Script - Version 70 Documentation - cPanel Documentation
Child pages
  • The manage_greylisting Script
For cPanel & WHM version 70

Skip to end of metadata
Go to start of metadata


The /usr/local/cpanel/scripts/manage_greylisting manages the cPanel Greylisting service. 

The /usr/local/cpanel/scripts/manage_greylisting script

To use the /manage_greylisting script to manage the Greylisting service, run the following command:

/usr/local/cpanel/scripts/manage_greylisting [options]


When you run the /manage_greylisting script, you can specify the following options:


Initialize the SQLite database with the basic data structure.


The SQLite database resides in the /var/cpanel/greylist/greylist.sqlite file.

/usr/local/cpanel/scripts/manage_greylisting --init 

Forcibly reset the SQLite database.


This option attempts to preserve the Trusted Hosts list if the Greylisting service runs on the server.

/usr/local/cpanel/scripts/manage_greylisting --reset

Trust the IP addresses for the common specified email services. Specify this option more than once to trust multiple services at the same time.

This script recognizes the following common email services:

  • aol
  • apple
  • att
  • bank_of_america
  • chase_bank
  • comcast
  • cpanel
  • firstdata
  • google
  • hotmail
  • mcafee_email_saas
  • microsoft
  • microsoft_eop
  • office365
  • outlook
  • roadrunner
  • sbcglobalnet
  • symantec_messagelabs
  • tucows_opensrs
  • verizon
  • wellsfargo
  • yahoo
/usr/local/cpanel/scripts/manage_greylisting --trust cpanel
--importImport the Trusted Hosts list that the specified JSON file contains.
/usr/local/cpanel/scripts/manage_greylisting --import /path/to/json/file

Export the current Trusted Hosts list.

To export the list to a file, specify the export_to option or redirect via STDOUT.

/usr/local/cpanel/scripts/manage_greylisting --export
/usr/local/cpanel/scripts/manage_greylisting --export --export_to export.json
/usr/local/cpanel/scripts/manage_greylisting --export > export.json

Update the common mail providers data in the database.


You can specify the --force flag with this option to forcibly update the IP address data in the database.

/usr/local/cpanel/scripts/manage_greylisting --update_common_mail_providers

Additional documentation