Overview
The Archive interface does not appear in your cPanel interface unless your system administrator enables the following settings:
The Enable Email Archiving support setting in the Mail section of WHM’s Tweak Settings interface (WHM >> Home >> Server Configuration >> Tweak Settings).
The Email Archiving feature in WHM’s Feature Manager interface (WHM >> Home >> Packages >> Feature Manager) for your account’s feature list.
This interface allows you to save incoming, outgoing, and mailing list messages for a specified amount of time. The system stores the messages in the mail directory in the user’s home directory. Each day, the system generates a new directory with the archivetype.YYYY-MM-DD format that contains all of the specified archive type’s messages.
When the system receives a message, it immediately archives the message.
This action occurs before the system applies any filters.
The system archives both spam and non-spam emails.
The system does not archive messages that you receive before you enable the Archive feature.
You can view the messages in the cPanel interface or in an email client.
This feature uses the Greenwich Mean Time (GMT) time zone to name directories, select messages to store in each directory, and timestamp messages. You cannot change this setting.
The amount of disk space that the system uses to archive messages increases in accordance with the length of time that you store mail. Make certain that significant space exists on your disk drive before you enable the Archive feature for a domain on your cPanel account.
Default Archive Configuration
To enable a default archiving configuration for all of your domains, perform the following steps:
Select the desired archive type.
Select the length of time for the system to retain messages in the archive. The interface will display a message that the Archive feature is enabled.
Click Apply to All My Domains to apply the default configuration to all of your domains.
Manage Archiving
The Manage Archiving table lists the archiving settings for each of your domains.
Modify a domain’s email archive
To make changes to an existing email archive configuration, perform the following steps:
In the table, locate the domain for which you wish to enable the email archive.
Select the desired archive type.
Select the length of time for the system to retain messages in the archive. The interface will display a message that the Archive feature is enabled.
IMAP Access
Automatic Configuration Scripts
To use a cPanel-provided automatic configuration script, perform the following steps:
-
Click the IMAP Access option next to the domain for which you wish to view messages. The Archive Mail Client Configuration interface will display.
-
Select either IMAP over SSL/TLS (recommended) or IMAP for your chosen mail client.
-
Follow the instructions to complete the setup.
-
Use the provided settings to manually set up a read-only configuration via IMAP.
Manual Settings
To manually configure your mail client, perform the following steps:
-
Click the IMAP Access option next to the domain whose messages you wish to view.
-
In the selected mail client, provide the following information, where
example.comrepresents your domain name:-
Mail Server Username:
archive@example.com- Your password is the same as your cPanel account password.
-
Incoming Mail Server: (SSL)
mail.example.com- IMAP port:
993
- IMAP port:
-
Incoming Mail Server: (non-SSL)
mail.example.com- IMAP port:
143
- IMAP port:
-
-
After you provide the information to your mail client, the daily directories appear in the folder list.
Download Archives
To download the archives to your local computer, perform the following steps:
- Click the Download Archives option next to the domain for which you wish to view messages.
Select from the following options:
All archives
Incoming
Mailing Lists
Outgoing
The system downloads a
.zipfile that contains the archived messages to your local computer.
Access Webmail
Click the Access Webmail link to view archived messages through Webmail.
Manage Disk Usage
You can delete messages from the archives to free up disk space.
To delete messages from the archives, perform the following steps:
Click Access Webmail for the domain that you wish to manage. The Webmail interface will appear.
In the top-right corner of the interface, click your archive’s email address. The User Preferences menu will appear.
Click Manage Disk Usage. The Manage Disk Usage interface will appear.
Click Manage for the mailbox that you wish to manage.
In the Messages to delete menu, select the message filter that you wish to use:
1 year or more.
30MB in size or more.
Previously viewed.
All messages.
Custom query. — This option allows you to use Dovecot query language to make your own filter.
Click Delete Permanently. A success message will appear.
