vdirsyncer/docs/server_support.rst
2014-06-15 11:15:13 +02:00

44 lines
1.8 KiB
ReStructuredText

==============
Server Support
==============
vdirsyncer is currently regularly and automatically tested against the latest
versions of Radicale and ownCloud. In principle, vdirsyncer is supposed to run
correctly with any remotely popular CalDAV or CardDAV server.
vdirsyncer's synchronization works best if the items have ``UID`` properties.
Items which don't have this property still should be synchronized fine as of
version 1.5, but for performance reasons, such items should rather be the
exception than the rule. For a possible way to automatically fix such items,
take a look at `vfix <https://github.com/geier/vfix>`_.
Radicale
========
Vdirsyncer is tested against the git version and the latest PyPI release of
Radicale.
- Radicale doesn't `support time ranges in the calendar-query of CalDAV
<https://github.com/Kozea/Radicale/issues/146>`_, so setting ``start_date``
and ``end_date`` for :py:class:`vdirsyncer.storage.CaldavStorage` will have
no or unpredicted consequences.
- Versions of Radicale older than 0.9b1 don't support the necessary
functionality for efficient querying for all items of a collection.
Vdirsyncer's defaults are supposed to deal with this situation, but if you're
using :py:class:`vdirsyncer.storage.CaldavStorage` and set ``item_types`` to
an empty value (``item_types =``), these versions of Radicale will not work
properly.
ownCloud
========
Vdirsyncer is tested against the latest version of ownCloud.
ownCloud uses SabreDAV, which had problems detecting collisions and
race-conditions. The problems were reported and are fixed in SabreDAV's repo.
See `Bug #16 <https://github.com/untitaker/vdirsyncer/issues/16>`_ for more
information.
However, given that this is a problem with every setup involving ownCloud, and
that ownCloud is widely used, it apparently isn't big enough of a problem yet.