How to Set Up Calendars and Contacts

Valid for versions 88 through the latest version

Version:

80

88


Last modified: February 28, 2020

Overview

Warning:

Because cPanel, L.L.C. doesn’t develop or ship these applications, cPanel Technical Support can’t help you set this up.

Important:
  • We strongly recommend that you use secure HTTP (https) for your connection.
  • If your server uses a self-signed certificate, your application will prompt you with the message Cannot Verify Server Identity. Tap Continue to complete the set up process.
  • Do not use your web browser to navigate to the URLs that cPanel’s Calendars and Contacts interface displays. They do not contain human-readable information.

You can set up cPanel calendars and contacts on Apple® desktop, mobile device operating systems, and in Roundcube 1.4.

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:

  • Serverexample.com:2080
  • User Nameexample or user@example.com
  • Password12345luggage
  • DescriptionMy Calendars
Note:
  • cPanel’s Calendars and Contacts feature does not function with the iOS® Reminder application if your server uses a self-signed SSL certificate, and does not support Horde’s Free/Busy system for third-party applications.
  • In cPanel & WHM version 54 and earlier, this is the Calendars and Contacts Client Configuration feature.

Set up calendar and contact applications

iOS®

These instructions are for iOS version 12.3.1 and 12.3.2.

1. Access the account configuration menu.

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

  1. Tap Settings.

  2. Tap Passwords & Accounts.

  3. Under ACCOUNTS, tap Add Account.

  4. Tap Other.

2. Add the appropriate account type.

Perform either of the following actions:

  • Under CONTACTS, tap Add CardDav Account to add a calendar account.
  • Under CALENDARS, tap Add CalDav Account to add a contacts account.

3. Enter your account information.

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

Note:

You must add port 2080 at the end of the server’s hostname for the setup to work correctly. For example, example.com:2080.

macOS® Catalina, El Capitan, Sierra, High Sierra, and Mojave

1. Access the account configuration menu.

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

  1. Click Launchpad, and then click System Preferences.

  2. Click Internet Accounts.

  3. Click Add Other Account….

2. Add the appropriate account type.

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

3. Enter your account information.

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

Note:

For calendar accounts (CalDAV), you must select Automatic from the Account Type menu.

Other operating systems

Important:

We have only tested these steps on Apple®-distributed products. These clients natively support CalDAV and CardDAV. If you use other calendar or contacts applications that support these protocols, you might be able to access your calendars and contacts from those applications. Your application must support the CalDAV and CardDAV protocols.

1. 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.

2. Enter your account’s information.

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.
    • Autodiscovery — example.com
    • Non-Autodiscovery cPanel account user — https://example.com:2080/rpc/principals/example
    • Non-Autodiscovery webmail user — https://example.com:2080/rpc/principals/user@example.com
      Note:

      If your application does not support Autodiscovery, use the non-autodiscovery URL.

  • Password — The cPanel account or webmail user’s password. For example: 12345password
Remember:

You can access this information in cPanel’s Calendars and Contacts interface (cPanel >> Home >> Email >> Calendars and Contacts).

Roundcube 1.4 for desktop

In cPanel & WHM version 88, we introduced Roundcube 1.4 to Webmail. 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. You can find instructions to set up a Horde calendar in Roundcube on mobile in the Roundcube 1.4 for mobile devices section of this document.

1. 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 Horde calendar to Roundcube, perform the following steps to obtain Horde’s CalDAV URL:

  1. In the 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 Horde CalDAV URL should resemble one of the examples below:

  • Non-Autodiscovery cPanel account user — https://example.com:2080/rpc/calendars/example/calendar:5aa73f09-6871-ed1c-ff63-1b93c5d1238b
  • Non-Autodiscovery webmail user — https://example.com:2080/rpc/calendars/user@example.com/calendar:5aa73f09-6871-ed1c-ff63-1b93c5d1238b

2. 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 your email address’s domain. 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 and Horde webmail clients. 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.

3. Navigate to the Roundcube Calendar interface.

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

4. Add the Horde 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 1 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 1.4 for mobile devices

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

1. 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 Horde calendar to Roundcube, perform the following steps to obtain Horde’s 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 Horde CalDAV URL should resemble one of the examples below:

  • Non-Autodiscovery cPanel account user — https://example.com:2080/rpc/calendars/example/calendar:5aa73f09-6871-ed1c-ff63-1b93c5d1238b
  • Non-Autodiscovery webmail user — https://example.com:2080/rpc/calendars/user@example.com/calendar:5aa73f09-6871-ed1c-ff63-1b93c5d1238b

2. 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 your email address’s domain. 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 and Horde webmail clients. 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.

3. 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.

4. Add the Horde 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 1 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.

Additional Documentation