How to configure calendars and contacts in cPanel

Overview

This document explains how to configure calendars and contacts using the CalDAV and CardDAV protocols on:

• Apple devices (iOS and macOS)

• Linux operating systems (such as Thunderbird)

In this article, user represents the Webmail user, and example.com represents the user's domain.

Important notes:

• cPanel technical support does not provide assistance configuring these applications, as they are not developed by them.

• You cannot add calendars or address books directly in Roundcube. To do so, use the Calendar and Contact Management interface in cPanel or Webmail.

---

Compatibility with other systems

Important:
This guide has been tested only on Apple products and the Thunderbird® email client, which natively support CalDAV and CardDAV.

Windows

You can use the free add-on Outlook CalDAV Synchronizer for Microsoft Outlook®.

Android

It is recommended to use the DAVx⁵ app.
More info: How to synchronize calendars and contacts on Android devices

---

Configuration data

Find this information in Webmail → Calendar and Contact Settings

Field	Example value
User	[email protected]
Password	Your Webmail password
Server URL	https://example.com:2080
Alternative URL	https://example.com:2080/principals/[email protected]/
CalDAV (calendar)	https://example.com:2080/calendars/[user]/calendar
CardDAV (contacts)	https://example.com:2080/addressbooks/[user]/addressbook

Note: If the primary URL fails, use the alternative to skip automatic detection (Autodiscover).

Do not open these URLs in your browser. They are not designed to be human-readable.

---

Configure on iOS

If you use a self-signed SSL certificate, you will receive a warning. Tap "Continue" to complete the process.
The Reminders app will not work with these calendars.

Steps:

1. Open Settings > Mail > Accounts > Add Account > Other

2. Choose:

   • Add CalDAV Account (for calendars)

   • Add CardDAV Account (for contacts)

3. Enter:

   • Server: example.com:2080 — don't forget the port

   • Username: your email

   • Password

   • Description: "Webmail Calendar"

4. Tap Next and enable sync

5. Choose to keep or delete local calendars

6. Save

---

Configure on macOS

1. Open Launchpad > System Settings > Internet Accounts

2. Click Add other account…

3. Select:

• CalDAV or CardDAV

Available methods:

Automatic

Only works if you don't use self-signed certificates. Not available for contacts.

Manual

1. Account type: Manual

2. Username and password

3. Server: example.com:2080

Advanced

1. Username and password

2. Server: example.com

3. Server path:

   • CalDAV: /calendars/user/calendar

   • CardDAV: /addressbooks/user/addressbook

4. Port: 2080

---

Configure on Linux (Thunderbird)

Calendars:

1. Open Thunderbird → click the Calendar icon

2. Click New Calendar > On the Network

3. Enter:

   • Username: your email

   • Location: https://example.com:2080

4. Find the calendar → authenticate → select CalDAV

5. Check "cPanel CalDAV Calendar" and click Subscribe

Contacts:

1. Click on the address book

2. Select Add CardDAV Book

3. Enter:

   • Username: your email

   • Location: https://example.com:2080

4. Log in and select "cPanel CardDAV Address Book"

5. Click Continue

---

Related documentation

• Webmail Interface

• Calendar and Contacts Server

• Calendar and Contacts Management

• Calendar Delegation

• Calendars and Contacts Sharing

---

Remember

You can now keep your Webmail events and contacts synchronized on any Apple or Linux device easily and securely. If you need additional help or want to configure Android or share calendars, check our documentation or contact us.