Difference between revisions of "Radicale"

From dmfswiki
Jump to: navigation, search
Line 33: Line 33:
  
 
The <code>/path/to/addressbook</code> is the path to your address book file relative to your <code>collections/</code> directory (configured as <code>filesystem_folder</code> in the <code>storage</code> section of Radicale's config).
 
The <code>/path/to/addressbook</code> is the path to your address book file relative to your <code>collections/</code> directory (configured as <code>filesystem_folder</code> in the <code>storage</code> section of Radicale's config).
 +
 +
It recommended to add the extension <code>.vcf</code> to your address book url to inform Radicale to create an address book instead of a calendar if the resource doesn't exist yet.
  
 
In order to use an anonymous user, you need a version of Radicale newer than 0.7.1 (the git version does it).
 
In order to use an anonymous user, you need a version of Radicale newer than 0.7.1 (the git version does it).

Revision as of 08:47, 12 October 2013

Radicale is a light-weighted open source CalDAV server written in python. It is easy to use and can even run without any configuration. It does not need a database like Mysql or Postgres as it stores all calendars as plain ics files in your file system.

Support for CalDAV-Sync has been added in version 0.6.

Setup

CalDAV-Sync

Please note that anonymous login (i.e. without user name) is currently not supported. You must enable authentication in Radicale to sync with CalDAV-Sync. The password can be empty, so you should be able to sync public and private calendars.

  • Server: <your.server.name>:5232
  • use SSL: leave ticked if you configured Radicale to use SSL
  • Username: <your user name>
  • Password: <your password>

To access calendars in the root directory (i.e. with URLs like /calendar) try:

  • URL: <your.server.name>:5232/<calendar_name>
  • use SSL: leave ticked if you configured Radicale to use SSL
  • Username: <some user name>
  • Password: may be empty

CardDAV-Sync

In order to use Radicale's CardDAV support, you need at least version 0.7.1, since there was an XML namespace error that prevented CardDAV-Sync from finding your address books that was only fixed in ea94ec9 (or check out calypso).

The account setup should work just as with CalDAV-Sync:

  • URL: <your.server.name>:5232/path/to/addressbook
  • use SSL: leave ticked if you configured Radicale to use SSL
  • Username: The user name known to the authentication method you configured in the [auth] section of Radicale's config file
  • Password: The corresponding password

The /path/to/addressbook is the path to your address book file relative to your collections/ directory (configured as filesystem_folder in the storage section of Radicale's config).

It recommended to add the extension .vcf to your address book url to inform Radicale to create an address book instead of a calendar if the resource doesn't exist yet.

In order to use an anonymous user, you need a version of Radicale newer than 0.7.1 (the git version does it).

Note that you have to access the address book at least once from another client to ensure it actually exists when you start the address book discovery since CardDAV-Sync will find only existing collections.

Known issues

Older versions of Radicale don't support the filter tag properly. They can't filter by component type (i.e. VEVENT or VTODO). That can cause problems if you have tasks and events in the same calendar collection. The issue is already fixed in the latest git version of Radicale. So either update your Radicale version or store tasks and events in separate calendars.