Repository navigation
Releases
3.9.2 Fixes+Performance
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_historyin upload - Performance: guard trace logging with isEnabledFor and use lazy formatting for logger calls
3.9.1 Features+Fixes (Security)
Fixes (Security)
- Fix: storage/hook: escape
$on all placeholder values received from external- credits to @sdushantha for report
- Fix: auth: reject empty login earlier and empty password on all external verification types
- credits to @sdushantha for report
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
MmandTtin 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
requeststo optional extraoauth2for OAuth2 authentication (pip install radicale[oauth2]) - Change: move
pikato optional extrarabbitmqfor 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 Actionsview=freebusy, and the WebUI link).format=vfreebusystill 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)
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)
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
Features
- Add: read-only free/busy view via GET ?view=freebusy
- Add: sharing/token: plain GET and HEAD serve free/busy when Actions config
viewisfreebusy - Add: WebUI read-only free/busy calendar URL under each calendar
- Add: rights permission
fto 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
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
Features
- Feature: [sharing] add sharing-by-group/realm
- Feature: [group] with type "htgroup", "none", "from_auth" (NEW)
- In case
[auth] type=ldapand LDAP groups should be continued to be used, extend config with[group] type=from_auth
- In case
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
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
:
- ⛔ username starts or ends with
3.7.7 Fixes
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
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