nextcloud / nextcloud/documentation
Instructions for upgrading the snap install are incomplete/misleading
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 628
- Forks
- 2.5k
- Avg merge
- 2d 11h
- Merged PRs (30d)
- 135
Description
The instructions for upgrading snaps (in package_upgrade.rst) are incomplete resp. misleading because they only the commands sudo snap refresh nextcloud without mentioning channels.
Your Nextcloud installation from snap will usually be from a "channel" tied to a certain major version, so you will need to snap switch to change the channel to another major version first, e.g. if you're currenly on version 17, use sudo snap switch --channel=18 nextcloud to switch to version 18.
Also, the follow-up command mentioned to complete the upgrade, currently mentioned as sudo -u www-data php occ upgrade, should be sudo nextcloud.occ upgrade instead on a modern snap installation instead.
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
Open package_upgrade.rst and review the snap upgrade instructions. Ensure they cover switching channels with snap switch before snap refresh, and use sudo nextcloud.occ upgrade as the follow-up command; the documentation is done when these steps accurately describe upgrading between major versions.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- php
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 72/100