1. cPanel & WHM Documentation
  2. cPanel Knowledge Base
  3. Webmail
  4. How to Set Up Calendars and Contacts
webmail calendar dav

How to Set Up Calendars and Contacts

Valid for versions 120 through the latest version

Version:

110

120

Last modified: April 19, 2024

Overview

This document describes how to set up calendars and contacts on Apple® desktop and mobile-device operating systems using CalDAV and CardDAV.

On Android™ devices, we recommend using the third-party DAVx5 application to set up calendars and contacts. For more information, read our How to Synchronize Calendars and Contacts on Android Devices documentation.

In this document, user represents the webmail user, and example.com represents the user’s domain name.

Warning:
  • Because WebPros International, LLC doesn’t develop or ship these applications, cPanel Technical Support cannot help you set them up.
  • We have only tested these steps on Apple®-distributed products. These clients natively support CalDAV and CardDAV. If you use other calendars 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.
  • You cannot add calendars or address books directly in Roundcube. To add calendars and address books that you can access in Roundcube, use cPanel’s or Webmail’s Calendars and Contacts Management interface (cPanel » Home » Email » Calendars and Contacts Management or Webmail » Calendars and Contacts Management).

Configuration information

Important:

Do not use your web browser to navigate to the URLs that Webmail’s Calendars and Contacts Configuration interface (Webmail » Calendars and Contacts Configuration) displays. They do not contain human-readable information.

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

  • User Name — [email protected]
  • Password — Enter the same password that you use for your webmail login.
  • Server URL — https://example.com:2080
  • Alternate Server URL — https://example.com:2080/principals/[email protected]/
    Note:

    Some applications may not support Autodiscover. If the Server URL does not work, use the Alternate Server URL to bypass Autodiscover.

You can also reference calendars and contacts via their direct URLs in the Direct CalDAV and CardDAV URLs for Calendars and Contacts section of the interface. For example:

You can also have the system email you scripts that automatically configure the cPanel calendars and contacts on your local system. For more information, read the Set up email on your device section of our The Webmail Interface documentation.

Set up calendar and contact applications

Important:

Specific attributes of this tutorial may vary with future Apple product versions.

Perform the following steps for your operating system to set up cPanel calendars (CalDAV) and contacts (CardDAV):

iOS®

Note:

If your server uses a self-signed SSL certificate, the following caveats apply:

  • When you set up calendars and contacts, you will get a message that your local system cannot verify the server’s identity. Tap Continue to complete the setup process.
  • The iOS Reminder application will not function with the calendars you set up.

Access the configuration screen

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

  1. Tap Settings.
  2. Tap Mail.
  3. Tap Accounts.
  4. Tap Add Account.
  5. Tap Other.
  6. Tap the option for the type of account to add:
    • To add a calendar account, tap Add CalDAV Account under CALENDARS.
    • To add a contacts account, tap Add CardDAV Account under CONTACTS.

Enter your account information

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

  1. Enter your information in the appropriate text boxes. For example:
    • Server — example.com:2080
      Important:
      You must add :2080 at the end of the server name for the setup to work correctly.
    • User Name — [email protected]
    • Password — Enter the same password that you use for your webmail login.
    • Description — My Calendar Account
  2. Tap Next.

macOS®

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

Access the account configuration menu

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

  1. Click Launchpad, and then click System Settings.
  2. Click Internet Accounts.
  3. Click Add Other Account….
  4. Click CalDAV Account to add a calendar account, or CardDAV Account to add a contacts account.

Enter your account information

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

Automatic
Important:
  • You cannot use the Automatic method to set up your contacts.
  • You cannot set up calendars with the Automatic method if your domain uses a self-signed certificate.
  • If you experience issues with the Automatic method, use either the Manual or Advanced methods instead.

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

  1. Select Automatic in the Account Type menu.
  2. Enter your email address in the Email Address text box.
  3. Enter your password in the Password text box.
  4. Click Sign In to save your changes.
Manual

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

  1. Select Manual in the Account Type menu.
  2. Enter your email address in the User Name text box.
  3. Enter your password in the Password text box.
  4. In the Server Address text box, enter the server name, and add :2080 at the end.
    Important:

    You must add :2080 at the end of the server name for the setup to work correctly.

  5. Click Sign In to save your changes.
Advanced

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

  1. Select Advanced in the Account Type menu.
  2. Enter your email address in the User Name text box.
  3. Enter your password in the Password text box.
  4. Enter the server name in the Server Address text box.
  5. Enter the server path in the Server Path text box.
    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 for the calendar or address book you wish to add.
    • The Server Path text box only requires the information after the server’s port address. For example, to add a CalDAV Server Path, use the /calendars/[email protected]/calendar format.
  6. Enter 2080 in the Port text box.
  7. Click Sign In to save your changes.

Additional Documentation