Repository navigation
Instructions for upgrading the snap install are incomplete/misleading #8224
Description
Activity
We should consider just linking directly to the
nextcloud-snapREADME since that's the most authoritative for the Snap, most extensive, contains important context, and it's actively maintained.This would reduce duplicate documentation efforts and provide a better reader (user) experience.
https://github.com/nextcloud-snap/nextcloud-snap/blob/master/README.md
Relevant existing doc sections to revise:
Partially fixed. The incorrect
sudo -u www-data php occ upgradecommand is no longer in the doc. Butadmin_manual/maintenance/package_upgrade.rstlines 51-58 still only showsnap refreshandsnap revertwith no mention of channels.Users on a pinned major-version channel who run
snap refreshwon't get a major version upgrade. They need to runsudo snap switch --channel=<version> nextcloudfirst. This step is absent from the docs.The snap wiki is linked at line 60 but it's easy to miss. Either add the channel-switching step explicitly, or make the wiki link more prominent with a clear note that it's the authoritative reference for major version upgrades.
The instructions for upgrading snaps (in
package_upgrade.rst) are incomplete resp. misleading because they only the commandssudo snap refresh nextcloudwithout 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 switchto change the channel to another major version first, e.g. if you're currenly on version 17, usesudo snap switch --channel=18 nextcloudto 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 besudo nextcloud.occ upgradeinstead on a modern snap installation instead.