CS EN

Connecting via CalDAV (General Guide)

CalDAV is an open internet standard (RFC 4791) for accessing calendar data and synchronizing it in both directions. Thanks to CalDAV support in LockMyCal, you aren't tied to any proprietary provider and can easily connect any self-hosted or cloud server.

Note

Synchronization via CalDAV takes place directly between your LockMyCal instance and your calendar server. No data passes through third-party servers.

How CalDAV works in LockMyCal

sequenceDiagram
    participant C as Client (Booking site)
    participant L as LockMyCal Server
    participant D as Your CalDAV Server

    C->>L: Display available times
    L->>D: REPORT / calendar query for busy times (Busy)
    D-->>L: List of events and time blocks
    L-->>C: Display only genuinely free slots
    C->>L: Submit a new booking
    L->>D: PUT / create a new event (.ics)
    D-->>L: Write confirmation (201 Created)
  1. Reading busy times: LockMyCal regularly and in real time queries the selected calendars for the state of events (Busy/Free) and automatically excludes busy times from the booking form.
  2. Writing new meetings: After a booking is completed, LockMyCal creates a new calendar event with a formatted description, the attendees and a link to the video meeting directly in your CalDAV calendar.
  3. Detecting changes and cancellations: If you delete or move an event in the external calendar, LockMyCal takes these changes into account in the next availability evaluation.

General connection procedure

  1. In the dashboard, go to Integrations → Calendars → Connect calendar.
  2. Choose a provider – Nextcloud, Apple iCloud, Baïkal, Radicale, Zimbra, mailbox.org or a generic CalDAV server.
  3. Fill in:
    • Integration name: Your own label (e.g. Company Nextcloud).
    • Server address: The URL of your CalDAV server (it can also be entered without https://).
    • Username: Your login or email.
    • Password / app password: A strong password or a generated app password.
  4. Click Find calendars, select the calendars and click Save selection.

Both Basic and Digest authentication are supported. Servers on internal addresses (e.g. 192.168.x.x) require the variable ALLOW_PRIVATE_IPS_FOR_CALENDAR=true when self-hosting.

Tip

For security reasons, we strongly recommend generating a separate App Password in your CalDAV server's settings, with limited rights for the calendar only, instead of your main account password.

Guides for specific providers

Detailed step-by-step guides for the most popular CalDAV servers:

  • Nextcloud Calendar – A guide to connecting to a private Nextcloud cloud.
  • Apple iCloud – Setting up an Apple ID and an app password for the iCloud calendar.
  • Baïkal – Configuring a lightweight open-source CalDAV server.
  • Radicale – Connecting to a minimalist Python CalDAV server.
  • Zimbra – Integration with an enterprise groupware solution.
  • mailbox.org – A secure German email and calendar provider.