From 0efa74e2f4a86b404412eca68a231bcb2e93699b Mon Sep 17 00:00:00 2001 From: whoalin1 Date: Wed, 7 Oct 2026 03:39:48 +0300 Subject: [PATCH 1/2] docs(admin): snap channel switch and nextcloud.occ upgrade Assisted-by: Cursor:grok-4.7 Signed-off-by: whoalin1 --- admin_manual/maintenance/package_upgrade.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/admin_manual/maintenance/package_upgrade.rst b/admin_manual/maintenance/package_upgrade.rst index 0ce271174db..5c32c12424a 100644 --- a/admin_manual/maintenance/package_upgrade.rst +++ b/admin_manual/maintenance/package_upgrade.rst @@ -53,8 +53,27 @@ manually too by issuing the command: ``sudo snap refresh nextcloud`` +.. note:: + + Snap installs are usually tracked on a **channel tied to a major version** + (for example ``27`` or ``stable``). ``snap refresh`` alone only updates + within the channel you are already on. To move to a newer major release, + switch the channel first, then refresh:: + + sudo snap switch --channel=28 nextcloud + sudo snap refresh nextcloud + + Replace ``28`` with the target major channel from the + `release strategy `_. + If the upgrade fails you can easily revert to the last working version by issuing the command: ``sudo snap revert nextcloud`` +After a successful snap refresh that includes a Nextcloud major upgrade, finish +the database/app upgrade with the snap-wrapped ``occ`` (not a system +``php occ`` as ``www-data``):: + + sudo nextcloud.occ upgrade + Further documentation, an `extensive Wiki `_ and `FAQ's `_ can be found on the `developers GitHub `_. From 89f4312e8d6c1e48005fe1557a8314709c2cd224 Mon Sep 17 00:00:00 2001 From: whoalin1 Date: Fri, 23 Oct 2026 19:45:13 +0300 Subject: [PATCH 2/2] docs(admin): reword snap occ note to satisfy the occ syntax check Assisted-by: Cursor:grok-4.7 Signed-off-by: whoalin1 --- admin_manual/maintenance/package_upgrade.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/admin_manual/maintenance/package_upgrade.rst b/admin_manual/maintenance/package_upgrade.rst index 5c32c12424a..1628f155df2 100644 --- a/admin_manual/maintenance/package_upgrade.rst +++ b/admin_manual/maintenance/package_upgrade.rst @@ -71,8 +71,8 @@ If the upgrade fails you can easily revert to the last working version by issuin ``sudo snap revert nextcloud`` After a successful snap refresh that includes a Nextcloud major upgrade, finish -the database/app upgrade with the snap-wrapped ``occ`` (not a system -``php occ`` as ``www-data``):: +the database/app upgrade with the snap-wrapped ``occ`` command instead of +``sudo -E -u www-data php occ``:: sudo nextcloud.occ upgrade