Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified user_manual/groupware/images/macos_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified user_manual/groupware/images/macos_2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified user_manual/groupware/images/macos_3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified user_manual/groupware/images/macos_4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added user_manual/groupware/images/macos_5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added user_manual/groupware/images/macos_6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
42 changes: 23 additions & 19 deletions user_manual/groupware/sync_osx.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,40 +5,44 @@ Synchronizing with macOS
Setup your Accounts
-------------------

In the following steps you will add your server resources for **CalDAV** (Calendar)
and **CardDAV** (Contacts) to your Nextcloud.
In the following steps you will add **CalDAV** (Calendar)
and **CardDAV** (Contacts) to your macOS integrated Calendar and Contacts applications.
At the time of writing this guide, macOS is at version 26.3.1.

1. Open the **system preferences** of your macOS device.

2. Navigate to **Internet Accounts**:
1. Click on the Apple logo in the top left corner of your screen and select
**System Settings...** from the dropdown menu.

.. figure:: ./images/macos_1.png

3. Click on **Add Other Account…** and click on **CalDAV Account** for Calendar
or **CardDAV Account** for Contacts:
2. Navigate to **Internet Accounts**:

.. figure:: ./images/macos_2.png

.. note:: You can not setup Calendar/Contacts together. You need to setup them
in **separate accounts**.
3. Click on the small blue **choose from a list.**

4. Select **Manual** as Account-Type and type in your respective credentials:
.. figure:: ./images/macos_3.png

**Username**: Your Nextcloud username or email
4. Click on **add Other Account...**

**Password**: Your generated app-password/token (:ref:`Learn more<managing_devices>`).
.. figure:: ./images/macos_4.png

**Server Address**: URL of your Nextcloud server (e.g. ``https://cloud.example.com``)
5. Select **CalDAV Account** for calendar and **CardDAV Account** for contacts.

.. figure:: ./images/macos_3.png
.. figure:: ./images/macos_5.png

5. Click on **Sign In**.
.. note:: You can not setup Calendar/Contacts together. You need to setup them **separately**.

For **CalDAV (Calendar)**: You can now select, with which applications you want
to use this resource. In the most cases, this will be the "Calendar" application,
sometimes you may also want to use it for your **Tasks and reminders**.
6. Select **Manual** as Account Type and type in your respective credentials:

.. figure:: ./images/macos_4.png
**Username**: Your Nextcloud username or email

**Password**: Either your password or if you use 2FA your generated app-password/token (:ref:`Learn more<managing_devices>`).

**Server Address**: URL of your Nextcloud server (e.g. ``https://nextcloud.yourdomain.com``)

.. figure:: ./images/macos_6.png

7. Click on **Sign In**.

Troubleshooting
---------------
Expand Down