Sync Calendars, Contacts, and Files on UGMail over HTTPS

UGMail extends beyond email with three additional open protocols that make every mailbox a hub for calendars, contacts, and files. CalDAV keeps your schedules in sync across every device. CardDAV does the same for your address books. WebDAV lets you mount mailbox storage as a network drive or integrate it into file management workflows — all over standard HTTPS on port 443, and all using the same mailbox credentials you already have. All three protocols share the same connection details:

Setting	Value
Server	`https://mail.ugmail.co`
Port	`443`
Security	HTTPS
Username	Your mailbox email address
Password	Your mailbox password

Use your mailbox’s full email address as the username and the password you set via the secrets field in the Management API as the password.

CalDAV
CardDAV
WebDAV

CalDAV — calendar sync

CalDAV is the open standard for calendar synchronization defined in RFC 4791. Connect any CalDAV-capable calendar app to UGMail and your events, reminders, and schedules stay in sync across every device automatically.

Compatible clients

Apple Calendar (macOS, iOS, iPadOS)
Google Calendar (via CalDAV account type)
Mozilla Thunderbird with the Lightning / Calendar add-on
GNOME Calendar and Evolution (Linux)
Android via DAVx⁵ or similar sync adapters
Any standards-compliant CalDAV client

Connection details

Setting	Value
Server / URL	`https://mail.ugmail.co`
Port	`443`
Username	Your mailbox email address
Password	Your mailbox password

Configuration steps

Open your calendar app's account settings

Navigate to Settings → Accounts (or Internet Accounts on macOS/iOS) and choose Add Account. Select CalDAV or Other as the account type.

Enter the server URL

Set the server to https://mail.ugmail.co. Some clients label this field CalDAV Server, Server Address, or Account URL.

Enter your credentials

Set the username to your full mailbox email address (e.g. alice@example.com) and the password to your mailbox password.

Trigger discovery

Save or click Next. Your client will query the server for available calendars. Accept the calendars it finds and choose how frequently to sync.

Verify sync

Create a test event in the app and confirm it appears when you reload the calendar from another device or client connected to the same mailbox.

If your client requires a full CalDAV principal URL instead of just the base server, use https://mail.ugmail.co/dav/principals/alice@example.com/ — replacing the email address with your mailbox address.

CardDAV — contact sync

CardDAV is the open standard for contact synchronization defined in RFC 6352. Connect your address book app to UGMail and every contact you add, edit, or delete stays consistent across all your devices and clients.

Compatible clients

Apple Contacts (macOS, iOS, iPadOS)
Mozilla Thunderbird (built-in address book with CardDAV support)
GNOME Contacts and Evolution (Linux)
Android via DAVx⁵ or similar sync adapters
Outlook via third-party CardDAV connectors
Any standards-compliant CardDAV client

Connection details

Setting	Value
Server / URL	`https://mail.ugmail.co`
Port	`443`
Username	Your mailbox email address
Password	Your mailbox password

Configuration steps

Open your contacts app's account settings

Navigate to Settings → Accounts (or Internet Accounts on macOS/iOS) and choose Add Account. Select CardDAV or Other as the account type.

Enter the server URL

Set the server to https://mail.ugmail.co. Some clients label this field CardDAV Server, Server Address, or Account URL.

Enter your credentials

Set the username to your full mailbox email address (e.g. alice@example.com) and the password to your mailbox password.

Trigger discovery

Save or click Next. Your client will discover available address books on the server. Select the address books you want to sync.

Verify sync

Add a test contact and confirm it appears when you refresh the address book from another connected device or client.

If your client requires a full CardDAV principal URL, use https://mail.ugmail.co/dav/principals/alice@example.com/ — replacing the email address with your mailbox address.

On Android, install DAVx⁵ from F-Droid or Google Play. It handles both CalDAV and CardDAV in a single account setup, so you can sync both calendars and contacts with one set of credentials.

WebDAV — file storage

WebDAV (Web Distributed Authoring and Versioning) is defined in RFC 4918 and extends HTTPS to support file operations — creating, reading, updating, and deleting files and directories on a remote server. UGMail exposes WebDAV so you can mount your mailbox storage as a network drive on any desktop operating system or integrate it into automated file management workflows.

Compatible clients

macOS Finder — connect via Go → Connect to Server
Windows Explorer — map as a network drive
Linux — mount via GNOME Files, Dolphin, or the davfs2 kernel module
Cyberduck, WinSCP, Transmit, Cadaver, and other WebDAV-capable file managers
Any HTTP client or library that supports WebDAV methods (PROPFIND, PUT, DELETE, etc.)

Connection details

Setting	Value
Server / URL	`https://mail.ugmail.co`
Port	`443`
Username	Your mailbox email address
Password	Your mailbox password

Configuration steps

Choose your WebDAV client

Open the file manager or WebDAV client you want to use. The steps below are generic — consult your client’s documentation for exact menu labels.

Connect to the server

Enter the server URL https://mail.ugmail.co as the WebDAV address. In macOS Finder, go to Go → Connect to Server and enter the URL. In Windows Explorer, use Map Network Drive → Connect to a website. On Linux with davfs2, add an entry to /etc/fstab.

Authenticate

When prompted, enter your full mailbox email address as the username and your mailbox password as the password. Enable Remember credentials if you want the mount to persist across reboots.

Browse and manage files

Once connected, your UGMail file storage appears as a folder in your file manager. Copy, move, create, and delete files as you would on a local drive.

Automate with scripts

Use any HTTP library to perform WebDAV operations programmatically. The example below uses curl to upload a file.

Command-line example

Upload a file via WebDAV

# Upload a local file to your UGMail WebDAV storage
curl -u 'alice@example.com:SecurePassword123!' \
  -T './report.pdf' \
  'https://mail.ugmail.co/dav/files/alice@example.com/report.pdf'

List directory contents via WebDAV

# PROPFIND lists the contents of a WebDAV directory
curl -u 'alice@example.com:SecurePassword123!' \
  -X PROPFIND \
  -H 'Depth: 1' \
  'https://mail.ugmail.co/dav/files/alice@example.com/'

WebDAV over plain HTTP is not supported. Always use https:// to ensure your credentials and file contents are encrypted in transit.

Troubleshooting

The tips below apply to all three protocols.

Symptom	Likely cause	Fix
`401 Unauthorized`	Wrong username or password	Confirm the username is the full email address and the password matches the `secrets` field
`Connection refused`	Using `http://` instead of `https://`	Change the URL scheme to `https://` — plain HTTP is not supported
Client can’t discover resources	Client needs a full principal URL	Use `https://mail.ugmail.co/dav/principals/you@example.com/` as the account URL
Sync stops after password rotation	Cached credentials are stale	Update the password in your client’s account settings to match the new `secrets` value
Certificate error	Outdated system trust store	Update your operating system or install the latest CA certificate bundle

Get Started

Core Concepts

Protocols

Guides

Security

Sync Calendars, Contacts, and Files on UGMail over HTTPS

CalDAV — calendar sync

Compatible clients

Connection details

Configuration steps

CardDAV — contact sync

Compatible clients

Connection details

Configuration steps

WebDAV — file storage

Compatible clients

Connection details

Configuration steps

Command-line example

Troubleshooting

​CalDAV — calendar sync

​Compatible clients

​Connection details

​Configuration steps

​CardDAV — contact sync

​Compatible clients

​Connection details

​Configuration steps

​WebDAV — file storage

​Compatible clients

​Connection details

​Configuration steps

​Command-line example

​Troubleshooting

CalDAV — calendar sync

Compatible clients

Connection details

Configuration steps

CardDAV — contact sync

Compatible clients

Connection details

Configuration steps

WebDAV — file storage

Compatible clients

Connection details

Configuration steps

Command-line example

Troubleshooting