From 9fe750dc2becb2f9547ba665a4320ca39f61468f Mon Sep 17 00:00:00 2001 From: Dimitri Huisman Date: Thu, 24 Sep 2020 16:43:18 +0200 Subject: [PATCH 1/2] Add FAQ entry for how to use webdav(radicale) --- docs/faq.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/faq.rst b/docs/faq.rst index c90fbc6a..054726c1 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -327,6 +327,19 @@ After successfull login the domain part will be striped and the rest used as use *Issue reference:* `575`_. + +How do I use webdav (radicale)? +``````````````````````````````` + +| To use webdav (radicale) you can configure your carddav/caldav client to use the following url: +| `https://example.com/webdav/user@example.com` +| As username you must provide the complete email address (user@example.com). +| As password you must provide the password of the email address. +| The user must be an existing Mailu user. + +*issue reference:* `1591`_. + + .. _`Postfix`: http://www.postfix.org/postconf.5.html .. _`Dovecot`: https://doc.dovecot.org/configuration_manual/config_file/config_file_syntax/ .. _`NGINX`: https://nginx.org/en/docs/ @@ -342,6 +355,7 @@ After successfull login the domain part will be striped and the rest used as use .. _`520`: https://github.com/Mailu/Mailu/issues/520 .. _`591`: https://github.com/Mailu/Mailu/issues/591 .. _`575`: https://github.com/Mailu/Mailu/issues/575 +.. _`1591`: https://github.com/Mailu/Mailu/issues/1591 Technical issues ---------------- From 5c4a8069e4a3f807556f719435da84b7ada24741 Mon Sep 17 00:00:00 2001 From: Dimitri Huisman Date: Sat, 26 Sep 2020 01:13:29 +0200 Subject: [PATCH 2/2] Add additional instructions for first time usage. --- docs/faq.rst | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/faq.rst b/docs/faq.rst index 054726c1..b292cd05 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -331,8 +331,13 @@ After successfull login the domain part will be striped and the rest used as use How do I use webdav (radicale)? ``````````````````````````````` -| To use webdav (radicale) you can configure your carddav/caldav client to use the following url: -| `https://example.com/webdav/user@example.com` +| For first time set up, the user must access radicale via the url `https://mail.example.com/webdav/.web` and then +| 1. Log in using the user's full email address and password. +| 2. Click 'Create new addressbook or calendar' +| 3. Follow instructions for creating an addressbook (for contact management) and calendar. +| +| Subsequently to use webdav (radicale), you can configure your carddav/caldav client to use the following url: +| `https://mail.example.com/webdav/user@example.com` | As username you must provide the complete email address (user@example.com). | As password you must provide the password of the email address. | The user must be an existing Mailu user.