CPanel/WHM Mail Troubleshooting

From SuperbHosting.net Support Wiki

Contents 1 Overview 2 Adding email accounts 3 Accessing web mail 4 Some Common Problems

Overview

The Email Manager allows a user to accomplish many different tasks involving email accounts. This includes creating email accounts, removing accounts, forwarding email, and more. To access the Email Manager, click on the icon above the words Email on the main screen of your CPanel/WHM interface.

To learn more about using the Email Manager, use the CPanel/WHM help link within the CPanel/WHM interface.

Adding email accounts

1. To access the Mail Menu, click on the icon above the word Mail on the main screen of your CPanel/WHM interface.
2. Click on the words Add/Remove Accounts to enter MAIL ACCOUNT MAINTENANCE.
3. Click on the words Add Account.
4. Enter the name of the account, the account's password, and the account's quota (amount of disk space the account can use) in their respective blank fields.
5. Click on the button labeled Create to create the account.

Accessing web mail

1. To access the Mail Menu, click on the icon above the word Mail on the main screen of your CPanel/WHM interface.
2. Click on the words Web Mail to enter a screen where you can select the web mail interface you wish to use.
3. Click on the icon of the mail program you wish to use.
4. You will now need to Login to the web mail program using the user name and password for the email account you wish to use.

• Alternatively you and your users can access web mail directly by using the website address on port 2096. (example https://www.somedomainname.com:2096/).

Some Common Problems

• You can very safely and usually very effectively fix most email related problems with CPanel/WHM by reinstalling Exim forcibly by logging into the server as root via SSH and executing /scripts/eximup --force.

• Most IMAP/POP related errors are likely permissions on the /usr/local/cpanel/bin/courier-auth binary (should be 0700/-rwx------ and owned by root).

• Other IMAP specific errors, including those generated by Webmail, are likely to do with the user's mail directory being missing or having the wrong ownership/permission. The /home/<username>/mail directory should be owned by the user of which it is for and the permissions should be 0770/drwxrwx---.

• It is recommended that CPanel/WHM administrators configure the "Update Config" within WHM to Automatic STABLE. Alternatively you may want to just set it to STABLE and execute "/scripts/upcp --force" regularly (weekly or more).