Skip to content

Commit 441c858

Browse files
committed
Add recommendation on using OAuth and app passwords
1 parent 0f269f2 commit 441c858

File tree

1 file changed

+5
-1
lines changed

1 file changed

+5
-1
lines changed

introduction.rst

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,13 +36,17 @@ How to start using DAVx⁵ on your Android device:
3636
#. Open DAVx⁵.
3737
#. Follow the instructions of the start screen (permissions, battery saving etc.).
3838
#. Tap on "⊕ Add account" to add a new account.
39-
#. Enter your base URL / email address and login credentials.
39+
#. Login using OAuth (preferred if supported) or base URL / email address and login credentials.
4040
You can get the base URL from your service provider and/or our `list of tested services <https://www.davx5.com/tested-with/>`_.
4141
#. Finish the steps to add the account.
4242
#. Select the address books and calendars/task lists you want to synchronize so that the respective switches are enabled.
4343
#. Force sync ("🗘 Synchronize") if you want the data to be available immediately.
4444
#. Access your address books, events and tasks using your favorite apps (Contacts, Calendar, OpenTasks, …).
4545

46+
If your provider doesn't support OAuth login, we strongly recommend using app passwords with DAVx⁵,
47+
if available. Using a dedicated app password for each app — like DAVx⁵ — keeps your main account
48+
password private and allows you to revoke access at any time.
49+
4650
When you create a contact/event, select the desired DAVx⁵ account as storage location.
4751
Local contacts/events will stay on your phone and not be synchronized. If you're using DAVx⁵ the first time, you may
4852
want to :faq:`transfer your local contacts to the CardDAV server <existing-contacts-are-not-synced>`.

0 commit comments

Comments
 (0)