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

For cPanel & WHM version 60

(Home >> Email >> Mailbox Conversion)


This interface allows you to convert the format of cPanel accounts' mailboxes.

The maildir format uses flat files, which cause systems with large mail archives to exhaust their inode resources quickly.

The mdbox format stores multiple messages in a file and uses a simpler indexing scheme. This format requires fewer files, reduces inode usage significantly, and decreases disk space usage.


Unlike the maildir format, the mdbox format does not support symlinks.

  • For example, when a cPanel account owner uses Webmail on an account that uses the maildir format, the system displays every mailbox of the account's email users. However, on a cPanel account that uses the mdbox format, the system only displays the cPanel account's mailbox. The system does not display the mailboxes of the account's other email users.
  • For more information about symlinks in Dovecot, read Dovecot's Symlinks documentation.

Convert mailboxes

The interface displays a summary of the accounts that use the mdbox and maildir formats. It also lists benefits and limitations for each format.

To convert an account's mailboxes from one format to the other, perform the following steps:

  1. Select the format to which to convert mailboxes and click Next.
  2. Select the account or accounts to convert with the appropriate checkboxes and click Next.
    • Use the navigation tools at the top of the table to search for and select accounts.
    • To return to the previous step in the procedure, click Previous.
  3. Click Convert to convert the mailboxes for the selected account or accounts.
    • To convert the mailboxes and keep the files for the old format, select Keep old mailbox files.


      If you select this option, the system creates a storage file in each account's /home/user/mail and /home/user/mail/domain/emailaccount directory. This file contains all of the account's email messages that existed before you converted the mailbox's format. The amount of mail that resides in this file does not count against the cPanel account's email account quota. However, this amount of mail does count against the cPanel account's disk space quota.

      • user represents the cPanel account's user.
      • domain represents the domain.
      • emailaccount represents the email account.

    • To return to the previous step in the procedure, click Previous.

After you click Convert, the interface displays the status and progress of the conversion of mailboxes, and any warnings.