Page tree
Skip to end of metadata
Go to start of metadata

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.44

( Home >> Server Configuration >> Tweak Settings )

Initial default/catch-all forwarder destination

This setting allows you to select the initial forwarding destination for new accounts’ default (catch-all) email addresses. The catch-all or default address handles email that is sent to nonexistent users on your server's domains. Because a domain may receive a large number of spam messages for nonexistent users, if you opt to process this mail it can cost you server resources.

Note:

cPanel users can modify this forwarding destination in cPanel's Default Address interface (Home >> Mail >> Default Address).

 

You may choose from the following options:

  • System account (default) — The system will forward unroutable mail to the cPanel user’s main email account. If you choose this option, this account will mainly collect spam.
  • Fail — The system will discard the message and sends a notification to the sender.

    Note:

    Choose this setting if you receive mail attacks. 

  • Blackhole — The system will accept the message, discard it, and not notify the Remote SMTP server. 

    Note:

    $body

Discard FormMail-clone message with bcc:

This setting allows you to select whether to silently discard FormMail-clone messages that have a bcc: header in the subject line. Messages that meet this criteria are typically spam. This value defaults to On.

Warning:

This setting will not appear if you disable the exim service in WHM’s Service Manager interface (Home >> Service Configuration >> Service Manager)

 

Mail authentication via domain owner password

This setting allows you to specify whether to allow the use of website owner’s password to access any email address that the owner created within the account. This value defaults to Off.

 

Include mailman in disk usage calculations

This setting allows you to specify whether cPanel's disk usage calculations include Mailman mailing lists. This value defaults to On.

 

Email delivery retry time

This setting allows you to specify the number of minutes that your mail server waits before it attempts to redeliver a message after the message delivery fails. This value defaults to 60 minutes.

Warning:

This setting will not appear if you disable the exim service in WHM’s Service Manager interface (Home >> Service Configuration >> Service Manager)

Track email origin via X-Source email headers

This setting allows you to specify whether to track the origin of messages sent through your mail server. This feature adds X-Source headers to email messages. This value defaults to On.

Note:

This feature requires Exim version 4.34 or later.

Warning:

This setting will not appear if you disable the exim service in WHM’s Service Manager interface (Home >> Service Configuration >> Service Manager)


Max hourly emails per domain

This setting allows you to specify the maximum number of emails any domain can send per hour. This value defaults to Unlimited.

Warning:

  • This setting will not appear if you disable the exim service in WHM’s Service Manager interface (Home >> Service Configuration >> Service Manager).
  • This setting will not override the following settings :
    • Maximum Hourly Email by Domain Relayed
    • Maximum percentage of failed or deferred messages a domain may send per hour

 

The percentage of email messages (above the domain's hourly maximum) to queue and retry for delivery.

This setting allows you to specify whether to queue outgoing messages for later delivery after a domain reaches its limit for outgoing messages per hour. For example, if you set this value to 125, then after the domain reaches its hourly limit, Exim will queue any additional messages, up to 125% of the Max hourly emails per domain value. After the account reaches 125% of the Max hourly emails per domain value, any additional outgoing messages will fail.

To force failure of all outgoing messages after the domain reaches its limit, set this option to 100.

Warning:

This setting will not appear if you disable the exim service in WHM’s Service Manager interface (Home >> Service Configuration >> Service Manager)

Count mailman deliveries towards a domain's Max hourly emails

This setting allows you to specify whether to count messages to Mailman mailing lists against an account's Max hourly emails per domain limit. This setting defaults to Off.

Note:

This setting should remain set to Off if you wish to accommodate users with large Mailman mailing lists. If you turn this setting to On , you may encounter issues with mailing list subscribers who do not receive messages.

Maximum percentage of failed or deferred messages a domain may send per hour

This setting allows you to specify a percentage of failed or deferred messages. This setting defaults to unlimited .

Your server will temporarily block outgoing mail from a domain if both of the following conditions are true:

  • The percentage of failed or deferred messages, out of the total number of sent messages, is equal to or greater than the specified percentage.
  • The domain has sent at least the number of failed or deferred messages that the Number of failed or deferred messages a domain may send before protections can be triggered setting specifies.

If only one of these conditions is true, the system will not block outgoing mail. The system examines all outgoing and local mail over the previous hour to determine whether these conditions are true. For more information, read our Mail Limiting Features documentation.

Warning:

  • This setting will not appear if you disable the exim service in WHM’s Service Manager interface (Home >> Service Configuration >> Service Manager)
  • The system uses this setting in conjunction with the Number of failed or deferred messages a domain may send before protections can be triggered setting. Your server will not  temporarily block outgoing mail from a domain until the domain meets  both settings' requirements.

Number of failed or deferred messages a domain may send before protections can be triggered

This setting allows you to specify a number of failed or deferred messages. This setting defaults to 5.

Your server will temporarily block outgoing mail from a domain if  both  of the following conditions are true:

  • The domain has sent at least this number of failed or deferred messages.
  • The percentage of failed or deferred messages (out of the total number of sent messages) is equal to or greater than the percentage that the Number of failed or deferred messages a domain may send before protections can be triggered setting specifies.

If only one of these conditions is true, the system will not block outgoing mail. The system examines all outgoing and local mail over the previous hour to determine whether these conditions are true. For more information, read our  Mail Limiting Features  documentation.

Warning:

  • This setting will not appear if you disable the exim service in WHM’s Service Manager interface (Home >> Service Configuration >> Service Manager)
  • The system uses this setting in conjunction with the Maximum percentage of failed or deferred messages a domain may send per hour setting. Your server will   not  temporarily block outgoing mail from a domain until the domain meets  both   settings' requirements.

Restrict outgoing SMTP to root, exim, and mailman

This setting allows you to only allow the rootexim, and mailman users to send email messages. Enable this setting to deny other users on the system the ability to send mail. When you enable this setting, scripts and email users must use the sendmail binary to send mail and cannot use direct socket access. This value defaults to Off.

 

Prevent “nobody” from sending mail

This setting allows you to deny the nobody user the ability to send mail to a remote address. The default value for this item is Off.

Note:

PHP and CGI scripts generally run as the nobody user. To use a PHP or CGI script to send mail, enable the suEXEC or mod_php modules in your Apache configuration.

 

Add X-PopBeforeSMTP header for mail sent via POP-before-SMTP

Note:

This setting requires Exim 4.34-30+.

This setting allows you to require the mail server to append a list to the  X-PopBeforeSMTP  headers of all of that user's outgoing messages. This list contains all of the email addresses that a user checks with POP before SMTP. POP before SMTP is an email protocol that allows users to check email from different IP addresses without the need to log in repeatedly. The default value for this item is  Off .

Warning:

  • This setting will not appear if you disable the exim service in WHM’s Service Manager interface (Home >> Service Configuration >> Service Manager) .  
  • We recommend that you do not enable this option because it may compromise the privacy of your users.

 

Enable BoxTrapper spam trap

This setting allows you to enable BoxTrapper. BoxTrapper is a spam prevention system that uses blacklists, whitelists, and ignore lists, and an automated response-verification system. This setting defaults to On.

Warning:

This setting will not appear if you disable the exim service in WHM’s Service Manager interface (Home >> Service Configuration >> Service Manager).  

Enable Email Archiving support

This setting allows you to enable email archiving support. Email archiving allows you to keep a copy of each email that your server sends or receives. The server immediately archives an email when it receives the message. This action takes place before the system applies any filters to the message, which means that the system archives both spam and non-spam messages. If you enable this feature, the amount of disk space that mail uses will double. This setting defaults to Off.

Warning:

This setting will not appear if you disable the exim service in WHM’s Service Manager interface (Home >> Service Configuration >> Service Manager).  

Enable Horde Webmail

This setting allows you to enable the Horde webmail client. Webmail allows cPanel users to access their email accounts with an Internet connection and a web browser. This setting defaults to On .


Enable RoundCube webmail

This setting allows you to enable the RoundCube webmail client. Webmail allows cPanel users to access their email accounts with an Internet connection and a web browser. This setting defaults to On .


Enable the SpamAssassin spam filter

This setting allows you to enable Apache SpamAssassin™. Apache SpamAssassin is a spam filtration program that scores incoming email and checks that score against a predefined limit. If the spam score exceeds this limit, the server will take the action that the domain owner specified in cPanel's  Apache SpamAssassin  interface (Home >> Mail >> SpamAssassin). You may discard mail or place it in a spam folder. This setting defaults to On.

For more information, see the Apache SpamAssassin website.

Warning:

  • This setting will not appear if you disable the exim service in WHM’s Service Manager interface (Home >> Service Configuration >> Service Manager) .  
  • If you make changes to Apache SpamAssassin's configuration, you must run the /usr/bin/sa-compile  script for your changes to take effect. 


Enable SpamAssassin Spam Box delivery for messages marked as spam (user configurable)

This setting allows you to enable Apache SpamAssassin’s spam box feature. The spam box, when you enable it, can receive incoming mail that Apache SpamAssassin marked as spam. This can be useful for users who have received a message that was falsely flagged as spam. This setting defaults to Off.

 

Enable SquirrelMail webmail

This setting allows you to enable the SquirrelMail webmail client. Webmail allows cPanel users to access their email accounts with an Internet connection and a web browser. This setting defaults to On .

 

Prefix “mail.” onto Mailman URLs

This setting allows you to specify whether the system should prefix Mailman URLs with mail. This setting defaults to Off.

 

Default user-defined quota value for new email accounts

This setting allows you to set the default quota that appears in cPanel's Email Accounts interface (Home >> Mail >> Email Accounts). This setting defaults to 250 MB. The maximum value is 2,048 MB.

 

Default quota option for new email accounts

This setting allows you to set the preselected quota option in cPanel's Email Accounts interface ( Home >> Mail >> Email Accounts ). This setting defaults to User-defined.