nextcloud / nextcloud/documentation

macOS/iOS configuration profile not in documentation

Open
#6,234 2 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

1. to develop client: 🤖🍏 mobile feature: authentication feature: caldav feature: carddav manual: user needs info
Dominant language
JavaScript
Stars
628
Forks
2.5k
Avg merge
2d 11h
Merged PRs (30d)
135

Description

There is a configuration file to set up apple devices for quite some time:
https://github.com/nextcloud/server/pull/10068

but nothing is mentioned in the documentation (https://help.nextcloud.com/t/why-is-there-a-macos-ios-configuration-file-in-nextcloud/80914).

For the automatic setup, there are still some points open: https://github.com/nextcloud/ios/issues/70

My question would be regarding 2FA, so you would have to login first via browser on your mobile to install the profile. Then this installs probably the links and then you would have to generate manually an app password? Can we streamline this a bit? And for the moment, we just document the linked file? On the other hand, just installing everything manually isn't that difficult if the .well-known redirections are set up correctly.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review the configuration file introduced by nextcloud/server#10068, the documentation page, and nextcloud/ios#70. Determine whether the profile and its manual setup, including the 2FA and app-password caveats raised here, can be documented clearly. Done means the supported setup path and any limitations are described in the documentation.

Written by the indexing model from the issue text.

Assessment

Tech stack
ios, macos
Domain
documentation, mobile-dev
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.