- This document is only valid for cPanel & WHM versions 78 and 80.
- Roundcube version 1.3.8 and earlier does not support email addresses that contain Unicode characters.
- We recommend that only experienced server administrators perform the steps in this document.
- cPanel Technical Support does not provide assistance with the instructions in this article.
For instructions on how to migrate SquirrelMail address books to Horde, read our Importing SquirrelMail Address Books to Horde documentation.
This document describes the
We deprecated SquirrelMail in cPanel & WHM version 74 and removed it in cPanel & WHM version 78. The
roundcube_squirrelmail_contact_import plugin migrates a SquirrelMail user's email contact list to their Roundcube address book. When a Roundcube user logs in to their email account after the hosting provider installs the plugin, the system migrates the user's SquirrelMail contacts to Roundcube.
Install and uninstall the plugin
To install the plugin, run the following command as the
The system adds the following files to the
To uninstall the plugin, run the following command:
You can configure the following options for the plugin in the
|Sets the full path to the SquirrelMail data directory.|
|Creates a touch file in the |
Checks for duplicate email addresses.
Creates a new email folder for imported SquirrelMail contacts.
If you enable this option and set the
Configures the type of information for the system to record in the cPanel user's
Configures the SquirrelMail files' character set.
To configure this option for the ASCII character set, leave this option blank.
The full configuration file will resemble the following example:
The roundcube interface
After you install the plugin, the system migrates any SquirrelMail contacts to Roundcube. These contacts reside in the SquirrelMail mailbox. This mailbox resides in the Personal Addresses mailbox in the Groups section of the roundcube interface.
The log data for this plugin resides in the
/home/username/logs/roundcube file and resembles the following example:
- In cPanel & WHM version 78, the log data resides in the
- In these filepaths,
usernamerepresents a cPanel user's username.
- This example displays a list of SquirrelMail address book migration errors.