Last modified: March 19, 2024

---

Overview

This document describes how to manually migrate Horde calendars and contacts to Roundcube in cPanel & WHM version 108 and higher. The migration process consists of two steps:

1. Export the data from Horde.
2. Import the data into Roundcube.

In cPanel & WHM version 108, we removed the Horde webmail client. We also created a set of scripts and plugins to migrate Horde contacts and calendar data from Horde to Roundcube. The scripts run automatically when the server updates to cPanel & WHM version 108, and the plugins run automatically each time the user logs in to Roundcube.

Some Horde calendar events and contacts may not migrate automatically to Roundcube or appear correctly in the Roundcube interface. If this occurs, perform the steps in this document to manually migrate the calendars and contacts from Horde to Roundcube.

Migrate Horde calendars

To migrate the Horde calendars, perform the following steps.

Export calendars

To export the Horde calendars, perform the following steps:

1. Run the /usr/local/cpanel/scripts/export_horde_calendars_to_ics script to export the Horde calendars to .ics files.
2. Copy the .ics files into the cPanel user’s icals directory in $HOME/.cpanel/icals, where $HOME is the user’s home directory. For example, if you exported the cptest user’s calendars to /home/cptest/calendars, run this command to copy the .ics files:

   cp -a /home/cptest/calendars/*.ics /home/cptest/.cpanel/icals

Import calendars

To import the Horde calendars, log in to Roundcube for each email account whose calendars you wish to import. The cpanelicsimport plugin automatically imports the calendars from the $HOME/.cpanel/icals directory into Roundcube, where $HOME is the user’s home directory.

The plugin imports all Horde calendar events into the default Roundcube calendar.

Import all calendar events

To import all Horde calendar events into a non-default Roundcube calendar, perform the following steps:

1. Download the .ics file you exported in the previous step.
2. Log in to Roundcube for the email account whose calendar you wish to import into a different calendar.
3. Click the Calendar icon ().
4. Click Import in the top panel.
5. In the Calendar menu, select the calendar to import.
6. Select All in the Events from menu.
7. Select the .ics file you exported in the previous step.
8. Click Import.

Move a single calendar event

To move a calendar event from the default calendar to a non-default calendar, perform the following steps:

1. Log in to Roundcube for the email account whose calendar you wish to import into a different calendar.
2. Click the Calendar icon ().
3. Enable both the default calendar and the target calendar.
4. Select the event you wish to move.
5. Click Edit.
6. In the Calendar menu, select the target calendar.
7. Click Save.
8. Disable, then re-enable the target calendar.

The event will appear in the target calendar.

Migrate Horde contacts

To migrate the Horde contacts, perform the following steps.

Export contacts

To export the Horde contacts, perform the following steps:

1. Run the /usr/local/cpanel/scripts/export_horde_contacts_to_vcf script to export the Horde contacts to .vcf files.

2. Copy the .vcf files into the cPanel user’s vcards directory in $HOME/.cpanel/vcards, where $HOME is the user’s home directory. For example, if you exported the cptest user’s calendars to /home/cptest/contacts, run this command to copy the .vcf files:

   cp -a /home/cptest/contacts/*.vcf /home/cptest/.cpanel/vcards

Import contacts

To import the Horde contacts, log in to Roundcube for each email account whose contacts you wish to import. The cpanelvcfimport plugin automatically imports the contacts from the $HOME/.cpanel/vcards directory into Roundcube, where $HOME is the user’s home directory.

The cpanelvcfimport plugin imports all Horde contacts into a single address book. To import Horde contacts into additional address books, perform the following steps:

1. Log in to Roundcube for the email account whose contacts you wish to import into additional address books.
2. Click the Contacts icon ().
3. Click Import in the top panel.
4. In the Import from file field, select the .vcf file you exported in the previous step.
5. In the Import group assignments field, select All (create groups if necessary).
6. Click Import.