LogoفارسیFA

How to Manually Migrate Horde Calendars and Contacts to Roundcube in cPanel & WHM

This article explains how to manually migrate Horde calendars and contacts to Roundcube in cPanel & WHM version 108 through 118. It covers exporting Horde data, placing it in the correct directories, and importing it into Roundcube using built‑in plugins or manual import tools.

Horde migrationRoundcube importcPanel webmail data transfer

~3 min read • Updated Feb 23, 2026

1. Overview


This guide explains how to manually migrate Horde calendars and contacts to Roundcube in cPanel & WHM versions 108 through 118. In version 108, cPanel removed the Horde webmail client and introduced automated migration scripts and plugins. However, some data may not migrate automatically, requiring manual export and import.


Warning: This procedure is only valid for cPanel & WHM version 118 and earlier. In version 120 and later, the Horde export scripts were removed.


Notes:

  • Only the root user can run the migration scripts.
  • Check plugin errors in:
    $HOME/logs/.php.error.log
    $HOME/logs/roundcube/errors.log
  • If data still does not appear correctly, open a cPanel Support ticket.


2. Migrate Horde Calendars


2.1 Export Calendars


Run the following script to export Horde calendars to .ics files:

/usr/local/cpanel/scripts/export_horde_calendars_to_ics

Copy the exported .ics files into the user’s Roundcube import directory:

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

Replace USER with the cPanel username.



2.2 Import Calendars Automatically


Log in to Roundcube for each email account. The cpanelicsimport plugin automatically imports all .ics files from:

$HOME/.cpanel/icals


All events are imported into the default Roundcube calendar.



2.3 Import All Events into a Non‑Default Calendar


  1. Download the exported .ics file.
  2. Log in to Roundcube.
  3. Click the Calendar icon.
  4. Click Import.
  5. Select the target calendar.
  6. Choose All under “Events from”.
  7. Select the .ics file.
  8. Click Import.


2.4 Move a Single Event to Another Calendar


  1. Log in to Roundcube.
  2. Open the Calendar interface.
  3. Enable both the default and target calendars.
  4. Select the event.
  5. Click Edit.
  6. Choose the target calendar.
  7. Click Save.
  8. Disable and re‑enable the target calendar to refresh.


3. Migrate Horde Contacts


3.1 Export Contacts


Run the following script to export Horde contacts to .vcf files:

/usr/local/cpanel/scripts/export_horde_contacts_to_vcf

Copy the exported .vcf files into the user’s Roundcube import directory:

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


3.2 Import Contacts Automatically


Log in to Roundcube for each email account. The cpanelvcfimport plugin automatically imports all .vcf files from:

$HOME/.cpanel/vcards


All contacts are imported into a single address book.



3.3 Import Contacts into Additional Address Books


  1. Log in to Roundcube.
  2. Click the Contacts icon.
  3. Click Import.
  4. Select the .vcf file.
  5. Choose All under “Import group assignments”.
  6. Click Import.


4. Conclusion


Although cPanel provides automated migration tools for Horde data, some calendars and contacts may require manual intervention. By exporting the data, placing it in the correct directories, and using Roundcube’s import tools, you can fully restore Horde calendars and contacts for any user.


Written & researched by Dr. Shahin Siami

Next Article