diff --git a/docs/faq.rst b/docs/faq.rst index 7b82a3cd..ee341425 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -242,10 +242,37 @@ correct syntax. The following file names will be taken as override configuration *Issue reference:* `206`_. -I want to integrate Nextcloud with Mailu +I want to integrate Nextcloud 15 (and newer) with Mailu ```````````````````````````````````````` -First of all you have to install dependencies required to authenticate users via imap in Nextcloud +1. Enable External user support from Nextcloud Apps interface + +2. Configure additional user backends in Nextcloud’s configuration config/config.php using the following syntax if you use at least Nextcloud 15. + +.. code-block:: bash + + array( + array( + 'class' => 'OC_User_IMAP', + 'arguments' => array( + '127.0.0.1', 993, 'ssl', 'example.com', true, false + ), + ), + ), + + +If a domain name (e.g. example.com) is specified, then this makes sure that only users from this domain will be allowed to login. +After successfull login the domain part will be striped and the rest used as username in Nextcloud. e.g. 'username@example.com' will be 'username' in Nextcloud. Disable this behaviour by changing true (the fifth parameter) to false. + +*Issue reference:* `575`_. + +I want to integrate Nextcloud 14 (and older) with Mailu +```````````````````````````````````````` + +1. Install dependencies required to authenticate users via imap in Nextcloud .. code-block:: bash @@ -255,14 +282,15 @@ First of all you have to install dependencies required to authenticate users via && docker-php-ext-configure imap --with-kerberos --with-imap-ssl \ && docker-php-ext-install imap -Next, you have to enable External user support from Nextcloud Apps interface +2. Enable External user support from Nextcloud Apps interface -In the end you need to configure additional user backends in Nextcloud’s configuration config/config.php using the following syntax: +3. Configure additional user backends in Nextcloud’s configuration config/config.php using the following syntax for Nextcloud 14 (and below): .. code-block:: bash array( array( 'class' => 'OC_User_IMAP', @@ -273,7 +301,7 @@ In the end you need to configure additional user backends in Nextcloud’s confi ), If a domain name (e.g. example.com) is specified, then this makes sure that only users from this domain will be allowed to login. -After successfull login the domain part will be striped and the rest used as username in NextCloud. e.g. 'username@example.com' will be 'username' in NextCloud. +After successfull login the domain part will be striped and the rest used as username in Nextcloud. e.g. 'username@example.com' will be 'username' in Nextcloud. *Issue reference:* `575`_.