> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mail.ugmail.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Sync Calendars, Contacts, and Files on UGMail over HTTPS

> Sync calendars with CalDAV, contacts with CardDAV, and mount file storage with WebDAV — all on UGMail at mail.ugmail.co:443 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.

<Tabs>
  <Tab title="CalDAV">
    ## CalDAV — calendar sync

    CalDAV is the open standard for calendar synchronization defined in [RFC 4791](https://datatracker.ietf.org/doc/html/rfc4791). 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

    <Steps>
      <Step title="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.
      </Step>

      <Step title="Enter the server URL">
        Set the server to `https://mail.ugmail.co`. Some clients label this field **CalDAV Server**, **Server Address**, or **Account URL**.
      </Step>

      <Step title="Enter your credentials">
        Set the username to your full mailbox email address (e.g. `alice@example.com`) and the password to your mailbox password.
      </Step>

      <Step title="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.
      </Step>

      <Step title="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.
      </Step>
    </Steps>

    <Note>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.</Note>
  </Tab>

  <Tab title="CardDAV">
    ## CardDAV — contact sync

    CardDAV is the open standard for contact synchronization defined in [RFC 6352](https://datatracker.ietf.org/doc/html/rfc6352). 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

    <Steps>
      <Step title="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.
      </Step>

      <Step title="Enter the server URL">
        Set the server to `https://mail.ugmail.co`. Some clients label this field **CardDAV Server**, **Server Address**, or **Account URL**.
      </Step>

      <Step title="Enter your credentials">
        Set the username to your full mailbox email address (e.g. `alice@example.com`) and the password to your mailbox password.
      </Step>

      <Step title="Trigger discovery">
        Save or click **Next**. Your client will discover available address books on the server. Select the address books you want to sync.
      </Step>

      <Step title="Verify sync">
        Add a test contact and confirm it appears when you refresh the address book from another connected device or client.
      </Step>
    </Steps>

    <Note>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.</Note>

    <Tip>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.</Tip>
  </Tab>

  <Tab title="WebDAV">
    ## WebDAV — file storage

    WebDAV (Web Distributed Authoring and Versioning) is defined in [RFC 4918](https://datatracker.ietf.org/doc/html/rfc4918) 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

    <Steps>
      <Step title="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.
      </Step>

      <Step title="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`.
      </Step>

      <Step title="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.
      </Step>

      <Step title="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.
      </Step>

      <Step title="Automate with scripts">
        Use any HTTP library to perform WebDAV operations programmatically. The example below uses curl to upload a file.
      </Step>
    </Steps>

    ### Command-line example

    ```bash Upload a file via WebDAV theme={null}
    # 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'
    ```

    ```bash List directory contents via WebDAV theme={null}
    # 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/'
    ```

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

## 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                    |