The documentation for `how-to/publishing/authenticate.rst` should at least specify one system keyring as an example

[linghengqian]

Check existing issues

• I've verified that this request isn't described by any existing issues.

Request

• The documentation for how-to/publishing/authenticate.rst should at least specify one system keyring as an example.
• Currently, https://documentation.ubuntu.com/snapcraft/latest/how-to/publishing/authenticate/#authenticate-with-a-keyring describes it as follows.

On systems where you wish to remain logged in, run snapcraft login. Snapcraft will attempt to use the system keyring. If no keyrings are installed or initialized, Snapcraft will fall back to file-based credential storage. The file-based storage is managed by Snapcraft. If you wish to import/export credentials, refer to the previous sections.

• I find this a bit odd for WSL users, because most WSL users new to snapcraft don't know what to install as a system keyring. There's no proper Linux desktop environment, and therefore no way to provide the necessary files for file-based storage.

sudo apt update && sudo apt upgrade --assume-yes
sudo snap install snapcraft --classic
sudo snap install multipass
sudo snap set snapcraft provider=multipass
snapcraft login

lingh@DESKTOP-58BHAE6:~$ snapcraft login
No keyring found to store or retrieve credentials from.
Recommended resolution: Ensure the keyring is working or SNAPCRAFT_STORE_CREDENTIALS is correctly exported into the environment
For more information, check out: https://documentation.ubuntu.com/snapcraft/stable/how-to/publishing/authenticate
Full execution log: '/home/lingh/.local/state/snapcraft/log/snapcraft-20260219-230047.517051.log'

• Most users will only know from internet searches that they need to additionally execute sudo apt install --assume-yes gnome-keyring, so why not write this command into the documentation? gnome-keyring can certainly be used under WSL2.
• 
• The early investigation is located at Provide the snapcraft package for rancher desktop rancher-sandbox/rancher-desktop#9847 .

Document location

https://documentation.ubuntu.com/snapcraft/latest/how-to/publishing/authenticate/#authenticate-with-a-keyring

[bepri]

Thanks for the feedback, @linghengqian! The research you've shared is quite helpful as well. I agree this could be improved :)

[syncronize-issues-to-jira]

Thank you for reporting your feedback to us!

The internal ticket has been created: https://warthogs.atlassian.net/browse/SNAPCRAFT-1296.

This message was autogenerated