External Storage SFTP public-key authentication setup is misleading and the “Generate keys” option is missing
Nobody has claimed this yet.
- 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.

Steps to reproduce
- Setup NC
- Activate External storage
- 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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