The manage_greylisting Script

Valid for versions 82 through the latest version



Last modified: June 21, 2021


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

Run the 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:

Option Description Example
--init 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
--reset                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 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
--import Import the Trusted Hosts list that the specified JSON file contains.
/usr/local/cpanel/scripts/manage_greylisting –import /path/to/json/file
--export 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_common_mail_providers 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