Last modified: October 31, 2024

---

Overview

This document describes how to set up calendars and contacts via CalDAV and CardDAV on the Apple® and Linux® desktop operating systems and on Apple mobile devices.

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

Other operating systems

Microsoft Outlook® users can use the third-party Outlook CalDAV Synchronizer plugin to access their calendars and contacts on the Windows® operating system.

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

Configuration 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:

• Calendar — https://example.com:2080/calendars/[email protected]/calendar
• Address Book — https://example.com:2080/addressbooks/[email protected]/addressbook

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 calendars and contacts applications

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

iOS®

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.
3. Set the Calendars toggle to enable the calendar.
4. The Existing Local Calendars interface will appear. Tap Keep on My iPhone to keep your existing local calendars, or tap Delete to remove them.
5. Tap Save.

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

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.

Linux

We recommend the use of Thunderbird to access calendars and contacts on Linux desktop systems.

Set up calendars in Thunderbird

Perform the following steps to set up your calendars (CalDAV) account in Thunderbird on a Linux desktop computer:

1. Click the Calendars icon ().
2. Click New Calendar…. The Create New Calendar interface appears.
3. Select On the Network, then click Next.
4. Enter your email-account username in the Username text box.
5. Enter your domain in the Location text box in the following format: https://example.com:2080
   Important:

   You must add :2080 at the end of the domain name for the setup to work correctly.
6. Click Find Calendars.
7. The Authentication Required - Mozilla Thunderbird interface appears. Enter your email-account password in the text box, then click OK. The Create New Calendar interface appears.
8. Make sure that CalDAV is selected in the Calendar Type menu and the cPanel CalDAV Calendar checkbox is selected.
9. Click Subscribe. The cPanel CalDAV Calendar now appears in the Calendars menu.

Set up contacts in Thunderbird

Perform the following steps to set up your contacts (CardDAV) account in Thunderbird on a Linux desktop computer:

1. Click the Address book icon ().
2. Click the Create a new address book icon ().
3. Select Add CardDAV Address Book. The New CardDAV Address Book interface appears.
4. Enter your email-account username in the Username text box.
5. Enter your domain in the Location text box in the following format: https://example.com:2080
   Important:

   You must add :2080 at the end of the server name for the setup to work correctly.
6. Click Continue. The Authentication Required - Mozilla Thunderbird interface appears.
7. Enter your email-account password in the Password text box, then click OK. The New CardDAV Address Book interface appears.
8. Make sure the cPanel CardDAV Address Book checkbox is selected.
9. Click Continue. The cPanel CardDAV Address Book now appears in the All Address Books section.