Set Up CalDAV (Calendars) & CardDAV (Contacts) from your cPanel Server
Use this guide to connect your cPanel-hosted calendars and address books to iOS, macOS, and Linux (Thunderbird). It’s a clean-room rewrite based on cPanel’s official documentation so you can embed it directly on your site.
:2080 to the server name (for example, example.com:2080).- Your full email address (e.g.,
[email protected]) - Your webmail password
- Your server host (usually your domain) — often with
:2080
In Webmail, open Calendars and Contacts Configuration. It lists your DAV URLs and direct links for each calendar or address book.
If the plain server URL fails in a client, try the alternate URL (the one with /principals/[email protected]/) or use direct calendar/address‑book paths.
Configuration Cheatsheet
User Name: [email protected]
Password: (your webmail password)
Server URL: https://example.com:2080
Alt URL: https://example.com:2080/principals/[email protected]/
Direct CalDAV (calendar): https://example.com:2080/calendars/[email protected]/calendar
Direct CardDAV (contacts): https://example.com:2080/addressbooks/[email protected]/addressbook
Replace example.com and the email address with your actual values.
Set Up on Your Device
iOS (iPhone & iPad)Steps
- Open Settings → Mail → Accounts → Add Account → Other.
- Pick what you’re adding:
- CalDAV for calendars (Add CalDAV Account)
- CardDAV for contacts (Add CardDAV Account)
- Fill in:
- Server:
example.com:2080(include:2080) - User Name:
[email protected] - Password: your webmail password
- Description: anything you like
- Server:
- Tap Next, enable Calendars/Contacts as prompted, then Save.
- If asked about existing local calendars, choose Keep on My iPhone (or Delete if you prefer a clean slate).
Open Internet Accounts
- Launchpad → System Settings → Internet Accounts → Add Other Account…
- Choose CalDAV (calendar) or CardDAV (contacts)
Three ways to add
1) Automatic (Calendar only)
- Account Type: Automatic
- Email Address:
[email protected] - Password: your webmail password
- Click Sign In
2) Manual (recommended)
- Account Type: Manual
- User Name:
[email protected] - Password: your webmail password
- Server Address:
example.com:2080(must include:2080) - Click Sign In
3) Advanced (precise URLs)
- Account Type: Advanced
- User Name:
[email protected] - Password: your webmail password
- Server Address:
example.com - Server Path: use the path from Webmail’s configuration, e.g.
/calendars/[email protected]/calendaror/addressbooks/[email protected]/addressbook - Port:
2080 - Click Sign In
Calendars (CalDAV)
- Open the Calendar view.
- Click New Calendar… → choose On the Network → Next.
- Username: your email address
- Location:
https://example.com:2080(include:2080) - Click Find Calendars, then authenticate.
- Confirm CalDAV is selected and subscribe to the cPanel calendar shown.
Contacts (CardDAV)
- Open Address Book.
- Click Create a new address book → choose Add CardDAV Address Book.
- Username: your email address
- Location:
https://example.com:2080(include:2080) - Click Continue, authenticate, and ensure the cPanel CardDAV book is selected.
Troubleshooting
Connection fails on setup
- Verify you included
:2080with the server. - Try the Alternate principals URL from Webmail (bypasses Autodiscover).
- Use the direct calendar or address‑book paths in Advanced settings.
Self‑signed certificate alerts
- On iOS/macOS, you may need to Continue or trust the certificate.
- Consider installing a valid SSL certificate on the server for smoother setup.
Roundcube caveat
You can’t create calendars or address books directly inside Roundcube. Add them via cPanel/Webmail’s Calendars and Contacts Management so they appear in Roundcube.
This guide is an independently written summary to help end‑users and admins configure CalDAV/CardDAV with cPanel. Always verify your exact DAV URLs inside Webmail: Calendars and Contacts Configuration.
Originally based on cPanel’s public documentation “How to Set Up Calendars and Contacts.” Last reviewed: 10 March 2025. Trademarks belong to their respective owners.