docs:carddav

This is an old revision of the document!


CardDAV Inerface Documentation

As of version 3.0 the iAddressBook comes with a CardDAV interface that allows you to use the iAddressBook as your personal iCloud alternative. Just hook up your iPhone, Android phone or OSX Addressbook to your installation and the contacts will sync automatically between all the connected clients. Including Photo sync of course.

The iAddressbook uses SabreDAV (http://sabre.io) as the backend interface. Authentication and CardDAV support must be turned on. The client can then use the same user credentials used for login as defined in conf/auth.php. You can test the settings by going to your iAddressbook installation and adding /carddav.php to the URL as follows:

http://yourdomain.com/your_address_book/carddav.php

The demo installation also has CardDAV enabled so you can try this yourself right now: http://demo.iaddressbook.org/carddav.php

Clients will ask you to provide the URL to your CardDAV server. The exact syntax depends on the abilities of the client. If you have activated the .htaccess file that comes with the installation you should be able to use a very simple form (i.e. such as myserver.com/iaddressbook). Sometimes the simple format will not work and you have to be more specific. In order to get the right settings the following examples should guide you in finding the correct format. Try them one by one to see which one is required.

Before you start ensure you can login using your web browser (visit: http://myserver.com/iaddressbook/carddav.php)

  1. Start with: myserver.com/iaddressbook
  2. Try: https://myserver.com/iaddressbook (Make sure that you use http or https depending on your SSL support)

(Instructions for OSX Mavericks 10.9)

  1. Open OSX Addressbook
  2. Open the settings dialog
  3. Select tab Accounts
  4. Click the (+) symbol to add a new account
  5. Choose “Other account…” and click continue
  6. Type in your use name and password
  7. Type in the server address and click create
The settings for other OSX versions might change slightly. OSX can deal with the simple form (given you have activated the shipped .htaccess file). I noticed that the configuration worked fine in OSX Snow Leopard 10.8 while the implementation in Mavericks 10.9.5 still seems to be quite flaky. Apple seems to have introduced buggy code that suffers from race conditions. You have to try multiple times but it will work eventually.

short: it works but the client requires you to use https://myserver.com/iaddressbook/carddav.php/principals/<username>/

  1. instructions follow

short: it work too, much better than in iOS 6. Simple form works here too

  1. instructions follow

short: it work too, but for some reason contact photos are not synced back when set on the phone

  1. Go to the Play Store and get buy CardDAV-Sync
  2. instructions follow
  • docs/carddav.1428772242.txt.gz
  • Last modified: 17-11-2016 12:33
  • (external edit)