We have a new documentation site for cPanel & WHM! You can find our new documentation site at docs.cpanel.net.
We will continue to maintain our API documentation on this server.
cPanel & WHM offers three standard Webmail applications: Horde, SquirrelMail, and Roundcube.
To choose the best application for your needs, read our Which Webmail Application Should I Choose documentation.
If you do not see one of our Webmail applications, your hosting provider may have disabled it. For more information, contact your hosting provider to ask for it.
webmailproxy subdomain at account creation time.
example.comis the name of your domain.
The Horde Webmail application supports GnuPG (GPG) keys, which you can use to encrypt outbound email messages.
To use GPG keys with the Horde Webmail application, perform the following steps:
Click the Enable PGP functionality checkbox.
You must enable popup windows on your system, or Horde's PGP features will not function correctly.
Yes, you may access your email from any computer with a web browser and an Internet connection. For more information, read our How to Access cPanel & WHM Services documentation.
Yes. Users can go to
example.com is your domain name, to log in directly with the email account and password.
This is because, at some point, you clicked the Enable AutoLoad link in the Secure Webmail Login interface.
To disable auto-loading, perform the following steps:
If you cannot reach Webmail, perform the following steps:
2096in your firewall.
Ask your system administrator to run the following script and then restart Apache:
If you use POP3 protocol to download email, it will not update the server with read mail. We suggest that you switch to IMAP for email if your hosting provider uses IMAP.
The Webmail subdomain is part of a
vhost entry in Apache's
httpd.conf configuration file. The URL for the Webmail subdomain uses a
ScriptAliasMatch directive to map to the appropriate file system location.
Attempts to connect to either
mod_proxy module, which then forwards the initial TCP connection to the
cpservd service. The
cpservd daemon then contacts the browser and instructs it to listen on port
2095, or port
2096 for secure connections. Finally, the browser communicates with the server on port
2095 via TCP, or port
2096 for secure connections.
If you receive this error, your email inbox's memory may exceed the memory size limit that the system allocates for the cPanel PHP modules.
memory_limit setting in the
/usr/local/cpanel/3rdparty/etc/php.ini file restricts the maximum memory size of an email folder that you can export via Horde's export function. If your email inbox exceeds the
memory_limit setting, the export process will fail.
When you create a new email account, the Dovecot mail server creates a Junk mailbox by default. When you access that new email account via the Roundcube webmail application, Roundcube will create a separate, additional bulk spam mailbox. This behavior causes the Roundcube webmail interface to display a Junk mailbox and a spam mailbox.
To unsubscribe from either of these folders, perform the following steps in your Roundcube webmail interface:
Under the Folders heading, deselect the checkbox of the folder from which you wish to unsubscribe.
To create an autoresponder, perform the following steps.
Provide a body for your message. For example, you might enter the following message:
All email messages to your email account will receive this autoresponse until you remove it.
To remove the autoresponder, select Delete Autoresponder.
Contact your website's administrators to reset your password.
Users can change their passwords in the Webmail interface. Log in to the interface at
Yes. To forward email messages to multiple addresses, create email forwarders for each destination address.
For example, if you want
firstname.lastname@example.org to forward its mail to both
email@example.com, add the following forwarders:
You can do this in cPanel's Forwarders interface (cPanel >> Home >> Email >> Forwarders).
Do not create an email account for
firstname.lastname@example.org unless you want to also check that account's mail messages as
To forward all of the email for an address to another account, do not create an email account for that address. Instead, only create a forwarder.
For example, to deliver all of the mail that is sent to
email@example.com, without any emails saved in the
firstname.lastname@example.org account, add a forwarder from
email@example.com and do not create the
firstname.lastname@example.org email account.
Mail forwarders direct mail from one email address to another. For more information, read our Forwarders documentation.
To do this, create an email forwarder in cPanel. To send messages to the file rather than to a mailbox, do not create an email address. Instead, create a forwarder with the name of the address.
When you create the forwarder, choose the pipe to a program option. Then, put in the path of the file or program to which you wish to send mail.
To check your email status, perform the following steps:
to ensure that new mail exists.
The normal login is your email address and password (for example,
yourpassword). If that login information does not work, contact your hosting company for special instructions.
Each desktop email client maintains its own requirements to encrypt email messages with GPG keys. For directions on how to import GPG keys to your desktop email client, read your client's documentation.
The following links contain documentation for the most popular desktop email clients:
/usr/local/cpanel/whostmgr/bin/whostmgr2 killeximq command.
/etc/antivirus.exim is the Exim antivirus configuration file.
exim -d2 -bt email@example.com command to trace the email's path from the server.
To add a mail account manually, run the
Run the following script, where
example.com is your domain name:
For example, if the domain that you wish to allow is
mydomain.com, run the following script:
To avoid this issue, perform the following steps:
/usr/local/apache/conf/httpd.conf file, and move the vhost that it creates to be the first vhost.
The vhost that it creates is usually the last vhost in the file.
To avoid this issue, run the
/scripts/upcp script. This script detects the problem and fixes it for you automatically.
If it does not work, perform the following steps:
/scripts/upcpscript to rebuild Mailman with the correct UID and GID.
To flush the queue, run the following command:
To flush the queue and enable debugging, run the following command:
When you enable Apache SpamAssasin, the system reinjects messages into the mail queue. This passes the messages though the system filters and user filters. You will only receive one delivery to your inbox, but Exim will process the message twice.
mysqlto get the
Cut and paste the following lines into the
It is likely that the
cpwrap file has the wrong ownership. To correct this issue, run the following command:
/root/.forward file defines the email address that receives mail for the
The format of the file is a single email address on a line. For example:
Yes. Read ourdocumentation.
This problem has many possible causes. To find the cause, start with the following steps:
To change this port, perform the following steps:
You can set the number of emails per hour that a domain can send with the Max hourly emails per domain option in the Mail section of WHM's Tweak Settings interface (WHM >> Home >> Server Configuration >> Tweak Settings)
To add email accounts in cPanel, perform the following steps:
The default address feature in cPanel can alert a user that they sent an email to an invalid address.
To authorize a remote IP address to relay through Exim, perform the following steps:
/etc/exim.conf file, find the following lines:
Replace those lines with the following lines:
Server Name Indication (SNI) support allows you to host multiple SSL certificates for different domains on the same IP address. cPanel & WHM's Mail SNI support allows you to use any domain name that resolves to your IP address (for example,
example.com) as the incoming and outgoing mail servers, rather than the hostname (for example,
Set your mail server to the host name for SMTP, POP3, and IMAP instead of
mail.example.com. Then, ensure that your mail client uses the following ports for SSL:
Make certain that your account name is
user+example.com and that you use authentication on your SMTP server.
The Prefer IPv4 over IPv6 for outgoing mail setting determines whether Exim uses IPv4 first for outgoing mail.
cPanel & WHM ships with Apache SpamAssassin and BoxTrapper at no additional cost.
SPF is compiled in Exim, but is not enabled by default.
/scripts/enable_spf_dkim_globally script allows you to enable SPF and DKIM for accounts that exist on the server, and to create the appropriate DNS records for their domains. For more information, read our The enable_spf_dkim_globally Script documentation.
Yes, this functionality is enabled by default.
This functionality requires a valid cPanel license. If your license expires, mail delivery will continue to function. However, your mail client will not authenticate with the cPanel server. You must renew your cPanel license to reenable this service.
cPanel & WHM version 58 and later uses Dovecot® as the local mail delivery agent. Exim the mail transfer agent (MTA) receives inbound messages, connects to Dovecot via LMTP (Local Mail Transport Protocol), and Dovecot delivers the message. If LMTP is unavailable, the system uses the
dovecot_lda mail delivery agent to deliver messages.
Earlier versions of cPanel & WHM used Exim as both the mail transfer agent and the local delivery agent.
Yes, you can add RBLs in the Advanced section of WHM's Exim Configuration Manager interface (WHM >> Home >> Service Configuration >> Exim Configuration Manager).
If you edit your Exim configuration manually outside of the WHM interface, the next cPanel & WHM update may overwrite your changes.
The following two Apache SpamAssassin settings in the Basic Editor section of the Exim Configuration Manager interface (WHM >> Home Service Configuration >> Exim Configuration Manager) are mutually exclusive:
If you enable one of these options, the system will gray out the other option. If both options are grayed out, the outgoing spam scan option is enabled in the Advanced section of WHM's Exim Configuration Manager interface (WHM >> Home Service Configuration >> Exim Configuration Manager).
To disable this option, deselect the checkbox that corresponds to the outgoing_spam_scan option in the Advanced section of WHM's Exim Configuration Manager interface (WHM >> Home Service Configuration >> Exim Configuration Manager).
There is no content with the specified labels
There is no content with the specified labels
There is no content with the specified labels