Skip to content

Releases

3.9.2 Fixes+Performance

Choose a tag to compare

@pbiering pbiering released this 17 Nov 06:45

Fixes:

  • Fix: [server] report an inactive SSL protocol before assigning version 0
  • Fix: [auth] keep the LDAP server hostname as SNI when a CA file is set
  • Fix: propfind CS:getctag: use the sync-token so the value never repeats
  • Fix: [auth]: add server hostname as SNI option (ldap3+tls) for proper validation did not strip non-standard port
  • Fix: propfind: honor [storage] skip_broken_item=True (uncatched after changes in 3.9.1)
  • Fix: report: use [reporting] max_expand_occurrence also for unbounded RRULE enumeration

Performance

  • Performance: remove not required _clean_history in upload
  • Performance: guard trace logging with isEnabledFor and use lazy formatting for logger calls

3.9.1 Features+Fixes (Security)

Choose a tag to compare

@pbiering pbiering released this 12 Nov 08:51

Fixes (Security)

  • Fix: storage/hook: escape $ on all placeholder values received from external
  • Fix: auth: reject empty login earlier and empty password on all external verification types

Fixes

  • Fix: [sharing] owner cannot change the user or the mapped collection of a map-based share if not permitted to create it
  • Fix: doc of rights permissions Mm and Tt in reference config and SHARING.md
  • Fix: [auth]: add server hostname as SNI option (ldap3+tls) for proper validation
  • Fix: [sharing] CSV database: improve JSON parser for particular cells

Improvements

  • Improvement: auth/ldap: align catch of exceptions of python-ldap with python-ldap3
  • Improvement: extend USER/PATH blacklist "minimal" with backtick and $

Adjustments

  • Change: move requests to optional extra oauth2 for OAuth2 authentication (pip install radicale[oauth2])
  • Change: move pika to optional extra rabbitmq for the RabbitMQ hook (pip install radicale[rabbitmq])
  • Adjustment: CLI option --verify-storage returns now non-zero exit code in case of broken items are found and [storage] skip_broken_item=True

Extensions

  • Add: [sharing] permit_create_map = self: permit map-based sharing to self only (e.g. birthday calendar) without sharing with other users
  • Add: [rights] permission S: permit map-based sharing to self only, whatever permit_create_map is
  • Add: opt-in iTIP scheduling to email hook
  • Add: free/busy view returns one VEVENT per busy period (?view=freebusy, a token with Actions view=freebusy, and the WebUI link). format=vfreebusy still returns one VFREEBUSY

Features

  • Add: [server] type: serve with cheroot (HTTP/1.1, keep-alive; pip install radicale[cheroot])
  • Feature: support zstd compression for responses

Warning

In case of storage hook is in use with version >= 3.5.1, it's adviced to update immediately to 3.9.1

or apply workaround in file radicale/storage/multifilesystem/lock.py by adding .replace('$', '\\$') to "path" and "to_path" at external command generation command = self._hook % ... or takeover related current code of lock.py from here

or apply: [server] validate_path_value = strict (supported since 3.7.2) - may cause issues if strange path names already in use

Warning

In case of authentication via LDAP is active (supported since >= 3.3.0) and server is not rejecting unauthenticated named bind, it's adviced to update immediately to 3.9.1 or apply workaround in file radicale/auth/ldap.py by by adding short after the login function or takeover related current code of ldap.py from here:

  • 3.9.0
      def _login_ext_with_groups(self, login: str, password: str, context: auth.AuthContext) -> Tuple[str, set]
           if not login or not password:
               return auth.NO_LOGIN_NO_GROUPS

  • 3.3.0 - 3.8.3
      def _login(self, login: str, password: str) -> str:
           if not login or not password:
               return ""

Note

Builds for EL/Fedora are already available https://koji.fedoraproject.org/koji/packageinfo?packageID=16893

Important

Hint for non-RedHat Enterprise Linux for 3.9.1 and EL9 running into selinux-policy dependency issue: #2356

3.9.0 Features+Fixes (Security)

Choose a tag to compare

@pbiering pbiering released this 25 Oct 17:32

Fixes (Security)

  • Fix: auth/login-cache: partially missing thread-safety
  • Fix: auth/login-cache: add lock around remove expired entry
  • Fix: sharing/delete collection: fix uncatched collection URI without trailing '/'
  • Fix: auth/sharing+rights: refactoring "user_groups" handling to be thread-safe

Fixes

  • Fix: REPORT expand: non-recurring events with a TZID were time-range filtered by their local time read as UTC
  • Fix: typo in /.mobileconfig
  • Fix: empty text-match filter no longer fails the REPORT
  • Fix: WebUI/Sharing: property overrides on transformed shares
  • Fix: PUT request: accept If-Match: * for an existing item
  • Fix: REPORT with calendar-data parses every item with vobject just to count VEVENTs (10× slower than needed)
  • Fix: Honor zero-offset VALARM triggers in time-range filters
  • Fix: time-range filter on VTODO with only CREATED and COMPLETED
  • Fix: sharing: broken support for custom database_path
  • Fix: addressbook-query prop-filter defaults to test="anyof"

Improvements

  • Improvement: sharing/api: reject unsupported overlay properties depending on collection type and conversion
  • Improvement: sharing/bday: remove default "(BDAY)" suffix from overlayed "displayname"

Adjustments

  • Adjustment WebUI: show incoming shares as cards

Extensions

  • Extension: contrib/Apache reference config supports now also HTTP2
  • Extension: HTTP version added to request log

Features

  • Add: [server] type: serve with hypercorn, which additionally speaks HTTP/2 over cleartext (H2C) on the same socket (pip install radicale[h2])
  • Add: storage-hook supports now placeholder 'actor' (useful for shared collection)
  • Add: new permission 'l' for locking properties by blocking write access to properties (PROPPATCH) and suppressing write-properties (PROPFIND)

Warning

In case of use of group-based permissions, sharing or login-cache, it's adviced to update immediately to 3.9.0

Note

Builds for EL/Fedora are already available https://koji.fedoraproject.org/koji/packageinfo?packageID=16893

3.8.3 Fixes (Security)

Choose a tag to compare

@pbiering pbiering released this 08 Oct 05:44

Fixes (Security)

  • Fix: auth: clear rights/user_groups before conditional set depending on group_type/auth_type
    • credits to @d3do-23 reporting this as FO-RAD-2026-001 incl. suggestion for a fix
  • Fix: [group] htgroup: fix not working htgroup_cache=True
    • credits to @d3do-23 reporting this as FO-RAD-2026-002 incl. suggestion for a fix

Tip

@d3do-23: Wenhao Wu, Southeast University

Warning

Related to FO-RAD-2026-001, users which are using group-membership (LDAP/PAM/htgroup] based sharings are adviced to update immediately to 3.8.3 or at least apply manually a fix and restart the server:

File: radicale/app/__init__.py

  • Version >= 3.8.0 (around line 600)
+        self._rights._user_groups = set([])
         if user:
            group_type = self.configuration.get("group", "type")
  • Version >= 3.3.0 && < 3.8.0 (around line 550)
+       self._rights._user_groups = set([])
        if self.configuration.get("auth", "type") == "ldap":
            try:

3.8.2 Regressions and Feature

Choose a tag to compare

@pbiering pbiering released this 06 Oct 06:29

Features

  • Add: read-only free/busy view via GET ?view=freebusy
  • Add: sharing/token: plain GET and HEAD serve free/busy when Actions config view is freebusy
  • Add: WebUI read-only free/busy calendar URL under each calendar
  • Add: rights permission f to read free-busy time without event details

Extensions

  • Add: sharing/bday-conversion: X-RADICALE-NAME to generated bday items

Improvements

  • Improve: storage hook: avoid using preexc_fn, use process_group
  • Performance: guard expensive logging with isEnabledFor (where missed)
  • Performance: use lazy formatting for logger calls (where missed)

Fixes

  • Fix: free-busy REPORT returns one VFREEBUSY with FREEBUSY periods and no event details (RFC 4791)
  • Fix: free-busy REPORT does not expand transparent recurrences
  • Fix: sharing/bday-conversion: add proper RRULE and RECURRENCE-ID in case of "age" support is triggered
  • Fix: sharing/bday-conversion: do not serve item.vcf in parallel of item.ics
  • Fix: sharing/bday-conversion: adjust etag depending on template (item) or content (collection)
  • Fix: sharing/propfind: remove unexpected additional shares listed in case of request on collection with HTTP_DEPTH=1
  • Fix: sharing/propfind: suppress (resolved) shares having same URI as native ones
  • Fix: sharing/mkcol+mkcalendar: detect conflict with existing resolved shares
  • Fix: WebUI/sharing: display permissions and share-by-group
  • Fix: delete/sharing: neither allow resolved share nor still mapped collections to be deleted
  • Fix: sharing: resolved share resulting in same path as original requested will not have precedence

3.8.1 Fixes+Improvements+Extensions

Choose a tag to compare

@pbiering pbiering released this 24 Sep 05:15

Extensions

  • Add: tests: optional caldav-server-tester based CalDAV compatibility test suite (caldav_compat_tests)
  • Add: support for /.mobileconfig for authenticated user

Fixes

  • Fix: sharing/bday-conversion: add missing support for comma separated text components in vcard field N (name)
  • Fix: sharing: fix logic of permit/deny permissions for map (mM) and token (tT)
  • Fix: WebUI sharing/propatch issue
  • Fix: storage/sharing close unguarded os.scandir() iterators

Improvements

  • Improvement: rights/from_file: extend detection of conflicting/unsupported permissions on startup

3.8.0 Features+Fixes+Improvements+Adjustments+Extensions

Choose a tag to compare

@pbiering pbiering released this 03 Sep 05:42

Features

  • Feature: [sharing] add sharing-by-group/realm
  • Feature: [group] with type "htgroup", "none", "from_auth" (NEW)
    • In case [auth] type=ldap and LDAP groups should be continued to be used, extend config with [group] type=from_auth

Fixes

  • Fix: storage/multifilesystem: depth:1 PROPFIND no longer re-runs the filesystem collision check (path_to_filesystem) for every item in a collection; this made listing large collections O(n^2) on file systems not detected as collision-free
  • Fix: pathutils: detect missing permission to create symbolic link on Microsoft Windows
  • Fix: sharing-by-token: requests to dedicated items

Improvements

  • Improve: storage/multifilesystem: avoid redundant stat() calls per item in get/upload when use_mtime_and_size_for_item_cache is enabled

Extensions

  • Extension: [auth] type "pam": set groups of user to be used later
  • Extension: [hook] add option for "smtp_password_file"
  • Add: [group] group_collections_folder replacing hardcoded "GROUPS"

Adjustments

  • Adjustment: reject usernames starting or ending with "@" or having more than one "@"
  • Adjustment: reject usernames containing ":" or ","

3.7.8 Fixes+Improvements

Choose a tag to compare

@pbiering pbiering released this 06 Aug 06:13

Fixes

  • Fix: time-range filter on a VTODO having DTSTART/DUE and also CREATED/COMPLETED used the CREATED->COMPLETED duration instead of the DTSTART->DUE one, so completed tasks were missing from (or wrongly returned by) calendar-query REPORT results
  • Fix: sharing/proppatch: reject in case of write-access but 'p' is in permissions
  • Fix: sharing/by-map: catch collection path without trailing / (supporting "pimsync")

Improvements

  • Add: [report] max_expand_occurrence option to separate from max_freebusy_occurrence
  • Add: [system] max_vevent_rrule_occurrence option to catch DoS by problematic RRULE early enough (workaround for missing protection in current vobject version)

Note

  • planned to be the last release of 3.7.x

Warning

  • upcoming 3.8.0 will be enhanced with sharing-by-group/realm feature, internal technical limitations leads to required enhanced username syntax check, following (unusual) usernames will be no longer supported:
    • ⛔ username starts or ends with @
    • ⛔ username containing more than one @
    • ⛔ username containing :

3.7.7 Fixes

Choose a tag to compare

@pbiering pbiering released this 19 Jul 14:33

Fixes

  • Fix: web plugin helpers httputils.serve_resource/serve_folder ignored their mimetypes and fallback_mimetype parameters and always used the built-in mapping, so custom web plugins could not serve additional file types with a correct Content-Type
  • Fix: free-busy REPORT always failed with HTTP 400 ("FREEBUSY occurrences limit of 0 hit") when [reporting] max_freebusy_occurrence is set to 0 (limit disabled), because the limit check did not honor the disabled limit
  • Fix: time-range filter treated a VEVENT with a whole-day DURATION (e.g. P1D, P2D) as zero-length (timedelta.seconds instead of total_seconds), so such events were missing from calendar-query REPORT results
  • Fix: calendar-data expand (REPORT) left recurrence properties (e.g. RDATE) on the expanded single-occurrence VEVENTs; a single try/except around the sequential delattr() calls stopped at the first absent property (e.g. missing EXDATE), so later ones were never removed
  • Fix: text-match filter on a structured property (e.g. vCard N or ADR) crashed with HTTP 500 (AttributeError: 'Name'/'Address' object has no attribute 'lower') because vobject parses these into non-string objects; their text representation is now used
  • Fix: sharing bday-to-ICS conversion assigned the empty-FN fallback marker to the {nickname} placeholder instead of {fn}, so a VCARD with an empty FN got its NICKNAME overwritten with "!fn!" in the generated SUMMARY/DESCRIPTION and the {fn} fallback never resolved
  • Fix: sharing/delete: add forgotten backmap

3.7.6 Fixes+Extensions+Workaround+Improvements

Choose a tag to compare

@pbiering pbiering released this 07 Jul 05:25

Extensions

  • Extension: item verification on commandline
  • Extension: [auth] imap_append_domain option (optional)

Improvements

  • Improvement: catch lack of support of PERIOD in vobject <= 0.9.9

Fixes

  • Fix: sharing: backmap of REPORT/PROPPATCH hrefs is now URL-encode-aware (edit of a shared collection failed when the principal contains '@')

Workarounds

  • Workaround: remove trailing spaces on TZID and TZNAME appended by buggy Microsoft clients