Skip to content

Commit 0efa74e

Browse files
committed
docs(admin): snap channel switch and nextcloud.occ upgrade
Assisted-by: Cursor:grok-4.7 Signed-off-by: whoalin1 <whoalin414@gmail.com>
1 parent 2de9481 commit 0efa74e

1 file changed

Lines changed: 19 additions & 0 deletions

File tree

‎admin_manual/maintenance/package_upgrade.rst‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,8 +53,27 @@ manually too by issuing the command:
5353

5454
``sudo snap refresh nextcloud``
5555

56+
.. note::
57+
58+
Snap installs are usually tracked on a **channel tied to a major version**
59+
(for example ``27`` or ``stable``). ``snap refresh`` alone only updates
60+
within the channel you are already on. To move to a newer major release,
61+
switch the channel first, then refresh::
62+
63+
sudo snap switch --channel=28 nextcloud
64+
sudo snap refresh nextcloud
65+
66+
Replace ``28`` with the target major channel from the
67+
`release strategy <https://github.com/nextcloud-snap/nextcloud-snap/wiki/Release-strategy>`_.
68+
5669
If the upgrade fails you can easily revert to the last working version by issuing the command:
5770

5871
``sudo snap revert nextcloud``
5972

73+
After a successful snap refresh that includes a Nextcloud major upgrade, finish
74+
the database/app upgrade with the snap-wrapped ``occ`` (not a system
75+
``php occ`` as ``www-data``)::
76+
77+
sudo nextcloud.occ upgrade
78+
6079
Further documentation, an `extensive Wiki <https://github.com/nextcloud-snap/nextcloud-snap/wiki>`_ and `FAQ's <https://github.com/nextcloud-snap/nextcloud-snap/wiki/FAQ's>`_ can be found on the `developers GitHub <https://github.com/nextcloud-snap/nextcloud-snap>`_.

0 commit comments

Comments
 (0)