Difference between revisions of "Radicale"
(Document parameters for account detection with CardDAV-Sync) |
|||
| (6 intermediate revisions by 3 users not shown) | |||
| 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). | ||
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. | 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 == | ||
| + | |||
| + | There seem to a problem with Radicale 0.7 where the setup silently fails. An update to Radicale 0.9 fixes this issue. | ||
| + | |||
| + | === Calendar sharing and auto discovery === | ||
| + | |||
| + | Radicale supports calendars that are accessible by different users, but it doesn't support real calendar sharing. So CalDAV-Sync can only automatically discover the user's own calendars. If you want to add a shared calendar, you need to enter the calendar's URL during account setup. | ||
Latest revision as of 18:36, 24 August 2015
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.
Contents
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
There seem to a problem with Radicale 0.7 where the setup silently fails. An update to Radicale 0.9 fixes this issue.
Calendar sharing and auto discovery
Radicale supports calendars that are accessible by different users, but it doesn't support real calendar sharing. So CalDAV-Sync can only automatically discover the user's own calendars. If you want to add a shared calendar, you need to enter the calendar's URL during account setup.
