nextcloud / nextcloud/server

External Storage SFTP public-key authentication setup is misleading and the “Generate keys” option is missing

Open
#35,829 14 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

1. to develop 25-feedback bug feature: external storage papercut pending documentation
Dominant language
PHP
Stars
36.9k
Forks
5.2k
Avg merge
2d 3h
Merged PRs (30d)
713

Description

⚠️ This issue respects the following points: ⚠️
  • This is a bug, not a question or a configuration/webserver/proxy issue.
  • This issue is not already reported on Github (I've searched it).
  • Nextcloud Server is up to date. See Maintenance and Release Schedule for supported versions.
  • Nextcloud Server is running on 64bit capable CPU, PHP and OS.
  • I agree to follow Nextcloud's Code of Conduct.
Bug description

Trying to mount External Storage using SFTP and Public Key authentication in the user settings. The doc https://docs.nextcloud.com/server/25/admin_manual/configuration_files/external_storage/auth_mechanisms.html states that a key pair is generated by nextcloud. The Screenshot in the doc shows a generate keys button.

  • However, there actually is no such button. Instead, it wants me to enter a public key.
  • Also the text description seems misplaced. It says ... You may also allow users to mount their own external storage services. what is obviously an information supposed to be in the admin settings, but it is in the user settings of a non-admin account.

image

Steps to reproduce
  1. Setup NC
  2. Activate External storage
  3. Go to user settings -> External Storage
Expected behavior

Behavior should match what is described in the docs or the docs should be updated. Also Non-admin users should not see admin text description.

Installation method

None

Operating system

None

PHP engine version

None

Web server

None

Database engine version

None

Is this bug present after an update or on a fresh install?

None

Are you using the Nextcloud Server Encryption module?

None

What user-backends are you using?
  • Default user-backend (database)
  • LDAP/ Active Directory
  • SSO - SAML
  • Other
Configuration report

No response

List of activated Apps
External Storage
Nextcloud Signing status

No response

Nextcloud Logs

No response

Additional info

No response

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

Start by comparing the admin_manual/configuration_files/external_storage/auth_mechanisms.html documentation with the user settings → External Storage screen described in the issue. Verify the missing “Generate keys” option and misplaced admin text, then confirm that the documentation and non-admin UI agree when the work is complete.

Written by the indexing model from the issue text.

Assessment

Tech stack
php
Domain
authentication, documentation, frontend
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.