Overview

This article describes how to set up cPanel calendars and contacts on Apple® desktop, mobile device operating systems, and in Roundcube 1.5 using CalDAV and CardDAV.

On Android™ devices we recommend using Exchange ActiveSync to set up calendars, contacts, and email. For more information, read our How to Sync Calendars, Contacts, and Email on Android Devices documentation.

Configuration information

You can find your calendar (CalDAV) and contacts (CardDAV) setup information in cPanel’s Calendars and Contacts interface (cPanel » Home » Email » Calendars and Contacts). For example:

• Server — example.com:2080
• User Name — example or user@example.com
• Password — 123456luggage
• Description — My Calendars

Calendar delegation

You can manage calendar delegations through cPanel’s Calendar Delegation interface (cPanel » Home » Email » Calendar Delegation). This feature is useful for the following reasons:

• Create an account for a resource (for example, a conference room) and allow others to reserve it.
• Allow a manager to view their subordinates’ calendars.
• Allow an assistant to manage a manager’s calendar for them.

Set up calendar and contact applications

iOS®

Perform the following steps to access the calendars (CalDAV) and contacts (CardDAV) account configuration menu on your iOS device:

To access or set up CalDAV

To access the account configuration menu, perform the following steps:

1. Tap Settings.
2. Tap Calendar to add a calendar account.
3. Tap Accounts.
4. Under ACCOUNTS, tap Add Account.
5. Tap Other.
6. Under CALENDARS, tap Add CalDAV Account to add a calendar account.

To access or set up CardDAV

1. Tap Settings.
2. Tap Contacts to add a contacts account.
3. Tap Accounts.
4. Under ACCOUNTS, tap Add Account.
5. Tap Other.
6. Under CONTACTS, tap Add CardDAV Account to a contacts account.

Enter your account information

To complete the setup of your account, enter your information in the appropriate text boxes.

macOS®

Perform the following steps to access the calendars (CalDAV) and contacts (CardDAV) account configuration menu on your Apple computer:

Access the account configuration menu

1. Click Launchpad, and then click System Preferences.
2. Click Internet Accounts.
3. Click Add Other Account….

Add the appropriate account type

Click CalDAV Account to add a calendar account, or CardDAV Account to add a contacts account. Then, click Create.

Enter your account information

To complete the setup of your CalDAV or CardDAV account, use one of the following methods:

Automatic

To automatically complete the setup of your account, enter your information in the appropriate text boxes. Click Sign In to save your changes.

Manual

To complete the setup of your account manually, perform the following steps:

1. In the Account Type menu, select Manual.
2. Enter the account information in the text boxes.
3. Click Sign In to save your changes.

Advanced

To complete setup of your account using the Advanced option, perform the following steps:

1. In the Account Type menu, select Advanced.
2. Enter the account information in the text boxes.
   Note:

   • You can locate the CardDAV and CalDAV Server Path information in Webmail’s Configure Calendar and Contacts Client interface. Use the URL provided in the Secure SSL/TLS URLs table’s Address Book and Calendar rows, respectively.
   • The Server Path text box only requires the information provided after the server’s port address. For example, to add a CalDAV Server Path, use the /calendars/username/calendar:RANDOMUID format, where username is the account name, and calendar:RANDOMUID is the provided UID.
3. Click Sign In to save your changes.

Other operating systems

Access your application’s configuration interface

Perform the necessary steps to access the calendars (CalDAV) and contacts (CardDAV) account configuration interface for your application. These steps vary between applications. For more information, read your application’s documentation.

Enter your account’s information

In the following examples, example represents a user name, and example.com represents a domain name. Enter the following information:

• Username — Your cPanel account user or webmail user.
  • cPanel account user — example
  • Webmail user — user@example.com
• Server — The full URL to the user’s calendar or contacts.
  • Autodiscover — example.com
  • Non-Autodiscover cPanel account or webmail user — https://example.com:2080/calendars/__uids__/132E0D5F-77F2-4A15-B888-B0741C57F938/calendar
    Note:

    • Replace 132E0D5F-77F2-4A15-B888-B0741C57F938 with the actual UID (Unique Identifier) from the URL in the Calendars and Contacts interface (cPanel » Home » Email » Calendars and Contacts).
    • If your application does not support Autodiscover, use the non-Autodiscover URL.
• Password — The cPanel account or webmail user’s password. For example: 12345password

Roundcube for desktop

Roundcube’s database stores the internal calendar’s data. You can also add a CalDAV calendar to Roundcube. This version of Roundcube includes a mobile-responsive theme.

Access your calendar application’s configuration interface

Perform the necessary steps to access the calendars (CalDAV) and contacts (CardDAV) account configuration interface for your calendar application. These steps vary between calendar applications. For more information, read your calendar application’s documentation.

To access the CalDAV calendar in Roundcube, perform the following steps to obtain the CalDAV URL:

1. In the Calendars and Contacts interface (cPanel » Home » Email » Calendars and Contacts), scroll to the Direct CalDAV and CardDav URLs for Calendars and Contacts section.
2. Highlight and copy the URL for the Calendar type that you wish to use from the list.
   Note:

   We recommend that you use URLs from the Secure SSL/TLS URLs list.

The non-Autodiscover CalDAV URL should resemble this example:

https://example.com:2080/calendars/__uids__/132E0D5F-77F2-4A15-B888-B0741C57F938/calendar

Log in to Webmail and then to Roundcube

To log in to Webmail, you can use either of the following methods:

• Navigate to https://example.com:2096 in your browser. In this example, replace example.com with the domain for your email address. For more information, read our How to Log in to Your Server or Account documentation.

• Navigate to cPanel’s Email Accounts interface (cPanel » Home » Email » Email Accounts). Then, locate the email account in the table and click Check Email. The Webmail interface will open in a new browser tab.

After you first log in, the Webmail interface will appear.

cPanel & WHM ships with the Roundcube webmail client. Roundcube is cPanel & WHM’s default webmail client.

If Roundcube is not your current webmail client, click Roundcube’s logo or text description. You will see it in the Open your inbox section of the Webmail interface.

Navigate to the Roundcube Calendar interface

In the Roundcube interface, click Calendar on the left menu. The calendar interface will appear.

Add the CalDAV calendar to Roundcube

1. In the Roundcube Calendar interface, navigate to Calendars at the top of the interface. Click the menu ( ) icon. A menu will appear.

2. Select Add Calendar from the menu. The Create new calendar interface will appear.

   

3. In the Properties section, enter a calendar name in the Name text box.

4. Paste the calendar URL that you copied in step 2 in the CalDAV URL text box.

5. Adjust the calendar color and whether to show reminders in the Settings section.

6. Under Authentication, enter the username and password of your CalDAV digest.

7. Click Save. The Roundcube Calendar interface will automatically upload the calendar.

   Note:

   You will see calendar events for the current week.

    

To add an event to the calendar, double-click anywhere on the calendar. A New event interface will appear.

Roundcube for mobile devices

To add a CalDAV calendar to Roundcube for mobile devices, perform the following steps:

Access your calendar application’s configuration interface

Perform the necessary steps to access the calendars (CalDAV) and contacts (CardDAV) account configuration interface for your calendar application. These steps vary between calendar applications. For more information, read your calendar application’s documentation.

To connect the CalDAV calendar to Roundcube, perform the following steps to obtain the CalDAV URL:

1. In cPanel’s Calendars and Contacts interface (cPanel » Home » Email » Calendars and Contacts), scroll to the Direct URLs for Calendars and Contacts section.
2. Highlight and copy the URL for the Calendar type that you wish to use from the list.
   Note:

   We recommend that you use URLs from the Secure SSL/TLS URLs list.

The non-Autodiscover CalDAV URL should resemble this example:

https://example.com:2080/calendars/__uids__/132E0D5F-77F2-4A15-B888-B0741C57F938/calendar

Log in to Webmail and then to Roundcube

To log in to Webmail, you can use either of the following methods:

• Navigate to https://example.com:2096 in your mobile browser. In this example, replace example.com with the domain for your email address. For more information, read our How to Log in to Your Server or Account documentation.

• Navigate to cPanel’s Email Accounts interface (cPanel » Home » Email » Email Accounts). Then, locate the email account in the table and click Check Email. The Webmail interface will open in a new browser tab.

After you first log in, the Webmail interface will appear. cPanel & WHM ships with the Roundcube webmail client. Roundcube is cPanel & WHM’s default webmail client.

If Roundcube is not your current webmail client, click Roundcube’s logo or text description. You will see it in the Open your inbox section of the Webmail interface.

Navigate to the Roundcube Calendar interface

1. At the top of the Roundcube interface, click the menu () icon to open the main menu.

   

2. Select Calendar. The calendar interface will appear.

   

Add the CalDAV calendar to Roundcube

1. In the Roundcube Calendar interface, navigate to Calendars at the top of the interface. Click the menu ( ) icon. A menu will appear.

2. Select Add Calendar from the menu. The Create new calendar interface will appear.

   

   

3. In the Properties section, enter a calendar name in the Name text box.

4. Paste the calendar URL that you copied in step 2 in the CalDAV URL text box.

5. Adjust the calendar color and whether to show reminders in the Settings section.

6. Under Authentication, enter the username and password of your CalDAV digest.

7. Click Save. The Roundcube Calendar interface will automatically upload the calendar.

   Note:

   You will see calendar events for the current week.

    

   

To add an event to the calendar, double-click anywhere on the calendar. A New event interface will appear.