diff --git a/pages/user_documentation.rst b/pages/user_documentation.rst
index 3b6c254e..12015872 100644
--- a/pages/user_documentation.rst
+++ b/pages/user_documentation.rst
@@ -57,6 +57,7 @@ of:
- `CardDavMATE `_
- `Apple iPhone `_
- `Apple iCal `_
+- `Apple Contacts `_
- `syncEvolution `_
More clients will be supported in the future. However, it may work with any
@@ -340,9 +341,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
~~~~~~~~~~~~~