From 43dd8b82830cd210507ff251b7dc05c4f871ff6d Mon Sep 17 00:00:00 2001 From: scubamuc <54933878+scubamuc@users.noreply.github.com> Date: Mon, 3 Mar 2025 10:46:39 +0100 Subject: [PATCH 1/4] Update package_upgrade.rst scubamuc, snap-team changes Signed-off-by: scubamuc <54933878+scubamuc@users.noreply.github.com> --- admin_manual/maintenance/package_upgrade.rst | 39 ++++++-------------- 1 file changed, 11 insertions(+), 28 deletions(-) diff --git a/admin_manual/maintenance/package_upgrade.rst b/admin_manual/maintenance/package_upgrade.rst index 772326512..81a1d45d5 100644 --- a/admin_manual/maintenance/package_upgrade.rst +++ b/admin_manual/maintenance/package_upgrade.rst @@ -5,29 +5,25 @@ Upgrade via packages Upgrade quickstart ------------------ -One effective, if unofficial method for keeping Nextcloud current on Linux servers is by configuring -your system to use Nextcloud via a self-contained "Snap" package: a technology allowing users to -always have the latest version of an "app". +Nextcloud snap is designed to be easy to install and simple to maintain. The ideal Nextcloud snap is an "install and forget" Nextcloud instance that works on most architectures and updates itself without needing administrative skills. Combining Nextcloud with snapd makes it a perfect fit for IoT or scalable environments. Snapd is a secure and robust technology which the Nextcloud snap team has embraced. -That version from Canonical is quite restrictive. It is not aimed at developers or advanced users -who would want to tune their configuration by installing extra features. It is aimed at end-users -who want a no-brainer solution. Install it, use it. No need to worry about updating Nextcloud any -more. - -It will work for as long as Canonical pushes releases, just like with any other Linux package -maintained independently of Nextcloud. +However, the snap is very opinionated. Don't want to use Apache? Sorry, the snap uses it. Don't want to use MySQL? Sorry, that's what the snap uses. Something other than PHP whatever-we're-using? We picked the version we feel gives the best results. In other words, it's not very tinker-friendly. We don't do this to be mean, we do this so that we can reliably update it without your needing to worry about it. Installation ------------ **Ubuntu** -$ sudo snap install nextcloud + sudo snap install nextcloud **All other distros** (`be warned `_) +By default the latest stable Nextcloud snap release will be installed and it will automatically update to subsequent stable releases, but there are [other releases available as well](https://github.com/nextcloud/nextcloud-snap/wiki/Release-strategy) and you have full control of [automatic updates](https://github.com/nextcloud-snap/nextcloud-snap/wiki/Managing-automatic-updates). + +After installation, Nextcloud will start automatically. Assuming you and the device on which it was installed are on the same network, you will reach the Nextcloud installation by visiting `.local` or the IP address of the instance in your browser. If your hostname is `localhost` or `localhost.localdomain`, like on an Ubuntu Core device, `nextcloud.local` will be used instead. + * Go to https://docs.snapcraft.io/installing-snapd/6735 * Type the command to install snapd * Install Nextcloud ($ sudo snap install nextcloud) @@ -42,12 +38,6 @@ device (IoT), nextcloud.local will be used instead. You will be asked to create a password for "admin" and your favourite cloud will be ready -**Note** - -Do not use on IoT devices yet. You probably don't need these instructions anyway if you're -using Snappy Base 16.04 as it's currently unreleased. - - * Make a :doc:`fresh backup `. * Upgrade your Nextcloud snap: sudo snap refresh nextcloud * Run :ref:`occ upgrade `. @@ -57,11 +47,6 @@ using Snappy Base 16.04 as it's currently unreleased. Upgrade tips ------------ - -.. seealso:: - - If you upgrade from a previous major version please see :ref:`critical changes` first. - Upgrading Nextcloud from a Snap is just like upgrading any snap package. For example: @@ -75,15 +60,13 @@ this until you refresh your Nextcloud page. :scale: 75% :alt: Nextcloud status screen informing users that it is in maintenance mode. -Then use ``occ`` to complete the upgrade. You must run ``occ`` as your HTTP -user. This example is for Debian/Ubuntu:: +Then use ``nextcloud.occ`` to complete the upgrade. You must run ``nextcloud.occ`` as root. This example is for Debian/Ubuntu:: - sudo -u www-data php occ upgrade + sudo nextcloud.occ upgrade This example is for CentOS/RHEL/Fedora:: - sudo -u apache php occ upgrade - + sudo /snap/bin/nextcloud.occ .. _skipped_release_upgrade_label: @@ -100,7 +83,7 @@ for the moment If you have skipped any major releases you can bring your Nextcloud current with these steps: If you are using a Snap package: -sudo snap refresh nextcloud + sudo snap refresh nextcloud --stable If you did **not** install via a Snap package: From 5b35b214e34484ced08cd9cbb223907828eb9849 Mon Sep 17 00:00:00 2001 From: scubamuc <54933878+scubamuc@users.noreply.github.com> Date: Fri, 21 Mar 2025 22:49:35 +0100 Subject: [PATCH 2/4] Update package_upgrade.rst Formatting changes requested Signed-off-by: scubamuc <54933878+scubamuc@users.noreply.github.com> --- admin_manual/maintenance/package_upgrade.rst | 22 ++++++++++++++++---- 1 file changed, 18 insertions(+), 4 deletions(-) diff --git a/admin_manual/maintenance/package_upgrade.rst b/admin_manual/maintenance/package_upgrade.rst index 81a1d45d5..1cd0e4269 100644 --- a/admin_manual/maintenance/package_upgrade.rst +++ b/admin_manual/maintenance/package_upgrade.rst @@ -5,9 +5,17 @@ Upgrade via packages Upgrade quickstart ------------------ -Nextcloud snap is designed to be easy to install and simple to maintain. The ideal Nextcloud snap is an "install and forget" Nextcloud instance that works on most architectures and updates itself without needing administrative skills. Combining Nextcloud with snapd makes it a perfect fit for IoT or scalable environments. Snapd is a secure and robust technology which the Nextcloud snap team has embraced. +Nextcloud snap is designed to be easy to install and simple to maintain. +The ideal Nextcloud snap is an "install and forget" Nextcloud instance that works on most +architectures and updates itself without needing administrative skills. Combining Nextcloud +with snapd makes it a perfect fit for IoT or scalable environments. +Snapd is a secure and robust technology which the Nextcloud snap team has embraced. -However, the snap is very opinionated. Don't want to use Apache? Sorry, the snap uses it. Don't want to use MySQL? Sorry, that's what the snap uses. Something other than PHP whatever-we're-using? We picked the version we feel gives the best results. In other words, it's not very tinker-friendly. We don't do this to be mean, we do this so that we can reliably update it without your needing to worry about it. +However, the snap is opinionated. +- Nextcloud snap uses Apache. +- Nextcloud snap uses MySQL. +- Nextcloud snap uses PHP. +In other words, it's not very tinker-friendly. Installation ------------ @@ -20,9 +28,15 @@ Installation (`be warned `_) -By default the latest stable Nextcloud snap release will be installed and it will automatically update to subsequent stable releases, but there are [other releases available as well](https://github.com/nextcloud/nextcloud-snap/wiki/Release-strategy) and you have full control of [automatic updates](https://github.com/nextcloud-snap/nextcloud-snap/wiki/Managing-automatic-updates). +By default the latest stable Nextcloud snap release will be installed and it will automatically +update to subsequent stable releases, but there are [other releases available as well](https://github.com/nextcloud/nextcloud-snap/wiki/Release-strategy) +and you have full control of [automatic updates](https://github.com/nextcloud-snap/nextcloud-snap/wiki/Managing-automatic-updates). -After installation, Nextcloud will start automatically. Assuming you and the device on which it was installed are on the same network, you will reach the Nextcloud installation by visiting `.local` or the IP address of the instance in your browser. If your hostname is `localhost` or `localhost.localdomain`, like on an Ubuntu Core device, `nextcloud.local` will be used instead. +After installation, Nextcloud will start automatically. +Assuming you and the device on which it was installed are on the same network, you will reach the Nextcloud +installation by visiting `.local` or the IP address of the instance in your browser. +If your hostname is `localhost` or `localhost.localdomain`, like on an Ubuntu Core device, +`nextcloud.local` will be used instead. * Go to https://docs.snapcraft.io/installing-snapd/6735 * Type the command to install snapd From 28abae6be1d8cab715c23ad8aedbbb7247b658c2 Mon Sep 17 00:00:00 2001 From: scubamuc <54933878+scubamuc@users.noreply.github.com> Date: Sat, 22 Mar 2025 18:56:36 +0100 Subject: [PATCH 3/4] Update package_upgrade.rst Signed-off-by: scubamuc <54933878+scubamuc@users.noreply.github.com> --- admin_manual/maintenance/package_upgrade.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin_manual/maintenance/package_upgrade.rst b/admin_manual/maintenance/package_upgrade.rst index 1cd0e4269..4112135c3 100644 --- a/admin_manual/maintenance/package_upgrade.rst +++ b/admin_manual/maintenance/package_upgrade.rst @@ -5,7 +5,7 @@ Upgrade via packages Upgrade quickstart ------------------ -Nextcloud snap is designed to be easy to install and simple to maintain. +Nextcloud snap is an unofficial Nextcloud designed to be easy to install and simple to maintain. The ideal Nextcloud snap is an "install and forget" Nextcloud instance that works on most architectures and updates itself without needing administrative skills. Combining Nextcloud with snapd makes it a perfect fit for IoT or scalable environments. From 4ce3520e0f16b3e4e28da4cb261d290dbae12168 Mon Sep 17 00:00:00 2001 From: scubamuc <54933878+scubamuc@users.noreply.github.com> Date: Sat, 22 Mar 2025 18:59:19 +0100 Subject: [PATCH 4/4] Update package_upgrade.rst Signed-off-by: scubamuc <54933878+scubamuc@users.noreply.github.com> --- admin_manual/maintenance/package_upgrade.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/admin_manual/maintenance/package_upgrade.rst b/admin_manual/maintenance/package_upgrade.rst index 4112135c3..93a119221 100644 --- a/admin_manual/maintenance/package_upgrade.rst +++ b/admin_manual/maintenance/package_upgrade.rst @@ -7,8 +7,8 @@ Upgrade quickstart Nextcloud snap is an unofficial Nextcloud designed to be easy to install and simple to maintain. The ideal Nextcloud snap is an "install and forget" Nextcloud instance that works on most -architectures and updates itself without needing administrative skills. Combining Nextcloud -with snapd makes it a perfect fit for IoT or scalable environments. +architectures and updates itself without needing administrative skills. +Combining Nextcloud with snapd makes it a perfect fit for IoT or scalable environments. Snapd is a secure and robust technology which the Nextcloud snap team has embraced. However, the snap is opinionated. @@ -28,8 +28,8 @@ Installation (`be warned `_) -By default the latest stable Nextcloud snap release will be installed and it will automatically -update to subsequent stable releases, but there are [other releases available as well](https://github.com/nextcloud/nextcloud-snap/wiki/Release-strategy) +By default the latest stable Nextcloud snap release will be installed and it will automatically update to +subsequent stable releases, but there are [other releases available as well](https://github.com/nextcloud/nextcloud-snap/wiki/Release-strategy) and you have full control of [automatic updates](https://github.com/nextcloud-snap/nextcloud-snap/wiki/Managing-automatic-updates). After installation, Nextcloud will start automatically.