diff --git a/pages/user_documentation.rst b/pages/user_documentation.rst index 20792ddf..ef3ed771 100644 --- a/pages/user_documentation.rst +++ b/pages/user_documentation.rst @@ -60,6 +60,7 @@ of: - `CardDavMATE `_ - `Apple iPhone `_ - `Apple iCal `_ +- `Apple Contacts `_ - `syncEvolution `_ More clients will be supported in the future. However, it may work with any @@ -400,9 +401,53 @@ now set-up. You can close the ``Preferences`` window. Contacts ++++++++ -**Contacts do not work yet with Radicale and Apple's clients.** If you are -interested in this feature, please check this `bug report -`_. +To get Apple Contacts running, you'll need to get your hands dirty: + +0. If you use a self-signed ssl certificate, add the root certificate to your + keychain and grant full trust. +1. Open ``Preferences`` dialog of ``Contacts.app`` and click the ``+`` to + create a new account. +2. Select `Other contacts account`` and pick ``Card DAV``. +3. Enter the your credentials and the full server address + (``https://radicale.example.com:443/user1/addressbook.vcf/``). Then click + ``Create``. + The ``Contacts.app`` will now try to connect, but fail. Close the + application. +4. Go to ``~/Library/Application Support/AddressBook/Sources/``. +5. You should now see one or more directories named with UUIDs. + Open the one with the latest creation date. In there you should find a + ``Configuration.plist``. Open it in a text editor of your choice. +6. Make sure your ``Configuration.plist`` looks as follows (replace the + settings with the ones that apply to your environment). + +.. code-block:: Configuration.plist + + [...] + searchable + + serverName + radicale.example.com + serverPort + 443 + serverRootPath + /user1/addressbook.vcf/ + servername + https://radicale.example.com:443/user1/addressbook.vcf/ + useSSL + + userName + user1 + username + user1 + [...] + +.. note:: + You'll need to change values in the following keys: ``serverPort``, + ``serverRootPath`` and ``servername``. + The port numbers in the ``serverPort`` and ``servername`` keys and the + trailing slashes seem to be important. + +7. Open the ``Contacts`` application. syncEvolution ~~~~~~~~~~~~~