From 1b02cbbe98d66c49f73e3e65e6cbe1cdac483392 Mon Sep 17 00:00:00 2001 From: scubamuc <54933878+scubamuc@users.noreply.github.com> Date: Mon, 24 Mar 2025 22:27:49 +0100 Subject: [PATCH 1/4] Update package_upgrade.rst Nextcloud snap upgrade description as per documentation opn GitHub Signed-off-by: scubamuc <54933878+scubamuc@users.noreply.github.com> --- admin_manual/maintenance/package_upgrade.rst | 101 +++++-------------- 1 file changed, 24 insertions(+), 77 deletions(-) diff --git a/admin_manual/maintenance/package_upgrade.rst b/admin_manual/maintenance/package_upgrade.rst index 93a11922178..4f3919e2e5a 100644 --- a/admin_manual/maintenance/package_upgrade.rst +++ b/admin_manual/maintenance/package_upgrade.rst @@ -1,5 +1,5 @@ ==================== -Upgrade via packages +Upgrade via snap packages ==================== Upgrade quickstart @@ -12,102 +12,49 @@ Combining Nextcloud with snapd makes it a perfect fit for IoT or scalable enviro Snapd is a secure and robust technology which the Nextcloud snap team has embraced. 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. + +- Nextcloud snap uses recommended Apache. +- Nextcloud snap uses recommended MySQL. +- Nextcloud snap uses recommended PHP. Installation ------------ -**Ubuntu** +**On Ubuntu** - sudo snap install nextcloud +* https://snapcraft.io/nextcloud +* Install Nextcloud ``sudo snap install nextcloud`` **All other distros** - -(`be warned `_) +`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). +subsequent stable releases, but there are `other releases available as well `_ +and you have full control of `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) +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. 1st login --------- -After a successful install, assuming you and the device on which it was installed are on the -same network, you should be able to reach the Nextcloud installation by visiting .local in -your browser. If your hostname is localhost or localhost.localdomain, like on an Ubuntu Base -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 - -* Make a :doc:`fresh backup `. -* Upgrade your Nextcloud snap: sudo snap refresh nextcloud -* Run :ref:`occ upgrade `. -* Take your Nextcloud server out of :ref:`maintenance mode - `. -* Re-enable third-party apps. +Upon visiting the Nextcloud installation for the first time, you will be prompted to enter an admin username +and password before Nextcloud is initialised. This may take a while depending on resources and the device. +After you provide that information you will be logged in and able to install apps, create users, and upload files. Upgrade tips ------------ -Upgrading Nextcloud from a Snap is just like upgrading any snap package. -For example: - - sudo snap refresh nextcloud - -Your Snap package manager only upgrades the current Nextcloud Snap. Then -your Nextcloud server is immediately put into maintenance mode. You may not see -this until you refresh your Nextcloud page. - -.. figure:: images/upgrade-1.png - :scale: 75% - :alt: Nextcloud status screen informing users that it is in maintenance mode. - -Then use ``nextcloud.occ`` to complete the upgrade. You must run ``nextcloud.occ`` as root. This example is for Debian/Ubuntu:: - sudo nextcloud.occ upgrade +By default the Nextcloud snap will automatically update to subsequent stable releases. You may however upgrade +manuially too by issuing the command: -This example is for CentOS/RHEL/Fedora:: - - sudo /snap/bin/nextcloud.occ - -.. _skipped_release_upgrade_label: - -Upgrading across skipped releases ---------------------------------- - -.. seealso:: - - If you upgrade from a previous major version please see :ref:`critical changes` first. - -It is best to update your Nextcloud installation with every new point release, -and to never skip any major releases. While this requirement is being worked on, -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 --stable - -If you did **not** install via a Snap package: - -#. Upgrade your current version to the latest point release -#. Upgrade your current version to the next major release -#. Run upgrade routine -#. Repeat from step 2 until you reach the last available major release +``sudo snap refresh nextcloud`` + +If the upgrade fails you can easily revert to the last working version by issuing the command: -You'll find previous Nextcloud releases in the `Nextcloud Server Changelog -`_. +``sudo snap revert nextcloud`` -If upgrading via your Snap package manager fails, then you must perform a -:doc:`manual_upgrade`. +Further documentation, an `extensive Wiki `_ and `FAQ's `_ can be found on the `developers GitHub `_. From 6d5750af8a280457e73b59047d157d190dd140af Mon Sep 17 00:00:00 2001 From: scubamuc <54933878+scubamuc@users.noreply.github.com> Date: Wed, 26 Mar 2025 07:59:52 +0100 Subject: [PATCH 2/4] Update package_upgrade.rst correct spelling 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 4f3919e2e5a..cb8339abd91 100644 --- a/admin_manual/maintenance/package_upgrade.rst +++ b/admin_manual/maintenance/package_upgrade.rst @@ -49,7 +49,7 @@ Upgrade tips ------------ By default the Nextcloud snap will automatically update to subsequent stable releases. You may however upgrade -manuially too by issuing the command: +manually too by issuing the command: ``sudo snap refresh nextcloud`` From 3375a92338f51e9abae4310b7ef84a41bb965edf Mon Sep 17 00:00:00 2001 From: scubamuc <54933878+scubamuc@users.noreply.github.com> Date: Wed, 26 Mar 2025 10:05:08 +0100 Subject: [PATCH 3/4] Update package_upgrade.rst line too short, add "====" Signed-off-by: scubamuc <54933878+scubamuc@users.noreply.github.com> --- 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 cb8339abd91..6cdfaba21a7 100644 --- a/admin_manual/maintenance/package_upgrade.rst +++ b/admin_manual/maintenance/package_upgrade.rst @@ -1,6 +1,6 @@ -==================== +======================== Upgrade via snap packages -==================== +======================== Upgrade quickstart ------------------ From 09a125906f2009e11cfb310b92319244c6f8d260 Mon Sep 17 00:00:00 2001 From: scubamuc <54933878+scubamuc@users.noreply.github.com> Date: Wed, 26 Mar 2025 10:15:37 +0100 Subject: [PATCH 4/4] Update package_upgrade.rst one "=" corrected Signed-off-by: scubamuc <54933878+scubamuc@users.noreply.github.com> --- 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 6cdfaba21a7..0bc89747de2 100644 --- a/admin_manual/maintenance/package_upgrade.rst +++ b/admin_manual/maintenance/package_upgrade.rst @@ -1,6 +1,6 @@ -======================== +========================= Upgrade via snap packages -======================== +========================= Upgrade quickstart ------------------