Page tree
Skip to end of metadata
Go to start of metadata

Overview

Warning:

cPanel Support does not provide assistance with the instructions in this article.

This article provides instructions for how to set up cPanel calendars and contacts on Apple® desktop, mobile device operating systems, and Roundcube.

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 Name example or user@example.com

  • Password12345luggage

  • Description My Calendars

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.


Notes:

  • 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


Click the tab below that corresponds to your operating system or Webmail application.

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 Accounts & Passwords.
  3. Under ACCOUNTS, tap Add Account.
  4. Tap Other.

 


 

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.

 


 

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.

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

 


 

Add the appropriate account type.

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

 


 

Enter your account information.

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

Notes:

  • For calendar accounts (CalDAV), first select Manual from the Account Type menu. 
  • You must add mail to the beginning of the server's hostname for the setup to work correctly (for example, mail.example.com).

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 may be able to access your calendars and contacts from those applications. Your application must support the CalDAV and CardDAV protocols.

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.

Enter the following information:

TypeDescriptionsExample
UsernameYour cPanel account user or webmail user.
cPanel account user:
example
Webmail user:
user@example.com
ServerThe 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.

PasswordThe cPanel account or webmail user's password.12345password

Remember:

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

As of cPanel & WHM version 80, Roundcube ships with an internal calendar. Roundcube's database stores the internal calendar's data. You can also add a CalDAV calendar to Roundcube.

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

Log in to Webmail and then to Roundcube.

In the top-right corner of the interface, click your email address to access the User Preferences menu. From the User Preferences menu, select Roundcube (Webmail >> User Preferences menu >> Roundcube).


Navigate to the Roundcube Calendar interface.

In the Roundcube interface, click Calendar in the top menu on the right. The calendar interface will appear.


Add the CalDAV calendar to Roundcube.

  1. In the Roundcube Calendar interface, navigate to the Calendars left menu. Click the () icon. A menu will appear.
  2. Select CalDAV Calender from the menu. The Create new calendar window will appear.
  3. In the Properties tab, 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. Select the Authentication tab. 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 window will appear.

Additional documentation