From 2b71d3488f5bd41bd599fbe6fb6796fd2714721b Mon Sep 17 00:00:00 2001
From: Daphne Muller <86835268+DaphneMuller@users.noreply.github.com>
Date: Wed, 23 Sep 2026 12:36:35 +0200
Subject: [PATCH] Update sync_ios.rst

as per discussion in the Groupware helpdesk

Signed-off-by: Daphne Muller <86835268+DaphneMuller@users.noreply.github.com>
---
 user_manual/groupware/sync_ios.rst | 34 +++++++++++++++++++++++++-----
 1 file changed, 29 insertions(+), 5 deletions(-)

diff --git a/user_manual/groupware/sync_ios.rst b/user_manual/groupware/sync_ios.rst
index b97625eadcd..3b070d85dd9 100644
--- a/user_manual/groupware/sync_ios.rst
+++ b/user_manual/groupware/sync_ios.rst
@@ -2,10 +2,22 @@
 Synchronizing with iOS
 ======================
 
+Prerequisites
+-------------
+
+Generate an App password:
+
+#. In Nextcloud, go to Settings
+#. Go to Security
+#. Scroll down to Devices & sessions
+#. In 'App name' fill in for example 'iPhone'
+#. Keep the displayed App login and password for the next steps
+
 Calendar
 --------
 
-#. Open the settings application.
+Open the settings application on iOS:
+
 #. Select Apps.
 #. Select Calendar.
 #. Select Calendar Accounts.
@@ -13,14 +25,19 @@ Calendar
 #. Select Other as account type.
 #. Select Add **CalDAV** account.
 #. For server, type the domain name of your server i.e. ``example.com``.
-#. Enter your user name and password.
+#. Enter your App login as username.
+#. Enter your App password.
 #. Select Next.
 #. Open Advanced Settings
 #. For server, type the domain name of your server and path, i.e., ``example.com/remote.php/dav/principals/users/username/`` (replace **example.com** and **username**).
+#. Toggle 'SSL' on
+#. For port, fill in 443
 #. Close Advanced Settings
 
 Your calendar will now be visible in the Calendar application.
 
+.. note:: It may take a few minutes to synchronise all the events.
+
 .. note:: If you get an error message related to SSL, you can try the following: Make sure that you
    either specify both the protocol (``https://``) and the port (usually ``443``) in the ``Server`` field,
    i.e., ``https://example.com:443/remote.php/dav/principals/users/username/``,
@@ -36,16 +53,23 @@ Your calendar will now be visible in the Calendar application.
 Contacts
 --------
 
-#. Open the settings application.
+Open the settings application on iOS:
+
 #. Select Apps.
 #. Select Contacts.
 #. Select Contacts Accounts.
 #. Select Add Account.
 #. Select Other as account type.
 #. Select Add **CardDAV** account.
-#. For server, type the domain name of your server and path, i.e., ``example.com/remote.php/dav/principals/users/username/`` (replace **example.com** and **username**).
-#. Enter your user name and password.
+#. For server, type the domain name of your server i.e. ``example.com``.
+#. Enter your App login as username.
+#. Enter your App password.
 #. Select Next.
+#. Open Advanced Settings
+#. For server, type the domain name of your server and path, i.e., ``example.com/remote.php/dav/principals/users/username/`` (replace **example.com** and **username**).
+#. Toggle 'SSL' on
+#. For port, fill in 443
+#. Close Advanced Settings
 
 You should now find your contacts in the address book of your iPhone.