mirror of
https://github.com/nextcloud/documentation.git
synced 2025-08-20 14:15:54 +00:00
Update package_upgrade.rst
Nextcloud snap upgrade description as per documentation opn GitHub Signed-off-by: scubamuc <54933878+scubamuc@users.noreply.github.com>
This commit is contained in:
scubamuc
@ -1,5 +1,5 @@
|
|||||||
====================
|
====================
|
||||||
Upgrade via packages
|
Upgrade via snap packages
|
||||||
====================
|
====================
|
||||||
|
|
||||||
Upgrade quickstart
|
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.
|
Snapd is a secure and robust technology which the Nextcloud snap team has embraced.
|
||||||
|
|
||||||
However, the snap is opinionated.
|
However, the snap is opinionated.
|
||||||
- Nextcloud snap uses Apache.
|
|
||||||
- Nextcloud snap uses MySQL.
|
- Nextcloud snap uses recommended Apache.
|
||||||
- Nextcloud snap uses PHP.
|
- Nextcloud snap uses recommended MySQL.
|
||||||
In other words, it's not very tinker-friendly.
|
- Nextcloud snap uses recommended PHP.
|
||||||
|
|
||||||
Installation
|
Installation
|
||||||
------------
|
------------
|
||||||
|
|
||||||
**Ubuntu**
|
**On Ubuntu**
|
||||||
|
|
||||||
sudo snap install nextcloud
|
* https://snapcraft.io/nextcloud
|
||||||
|
* Install Nextcloud ``sudo snap install nextcloud``
|
||||||
|
|
||||||
**All other distros**
|
**All other distros**
|
||||||
|
`be warned <https://github.com/nextcloud-snap/nextcloud-snap/wiki/Why-Ubuntu-is-the-only-supported-distro/>`_
|
||||||
(`be warned <https://github.com/nextcloud-snap/nextcloud-snap/wiki/Why-Ubuntu-is-the-only-supported-distro/>`_)
|
|
||||||
|
|
||||||
By default the latest stable Nextcloud snap release will be installed and it will automatically update to
|
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)
|
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).
|
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.
|
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
|
Assuming you and the device on which it was installed are on the same network, you will reach the Nextcloud
|
||||||
installation by visiting `<hostname>.local` or the IP address of the instance in your browser.
|
installation by visiting ``<hostname>.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,
|
If your hostname is ``localhost`` or ``localhost.localdomain``, like on an Ubuntu Core device,
|
||||||
`nextcloud.local` will be used instead.
|
``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)
|
|
||||||
|
|
||||||
1st login
|
1st login
|
||||||
---------
|
---------
|
||||||
|
|
||||||
After a successful install, assuming you and the device on which it was installed are on the
|
Upon visiting the Nextcloud installation for the first time, you will be prompted to enter an admin username
|
||||||
same network, you should be able to reach the Nextcloud installation by visiting .local in
|
and password before Nextcloud is initialised. This may take a while depending on resources and the device.
|
||||||
your browser. If your hostname is localhost or localhost.localdomain, like on an Ubuntu Base
|
After you provide that information you will be logged in and able to install apps, create users, and upload files.
|
||||||
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 <backup>`.
|
|
||||||
* Upgrade your Nextcloud snap: sudo snap refresh nextcloud
|
|
||||||
* Run :ref:`occ upgrade <command_line_upgrade_label>`.
|
|
||||||
* Take your Nextcloud server out of :ref:`maintenance mode
|
|
||||||
<maintenance_commands_label>`.
|
|
||||||
* Re-enable third-party apps.
|
|
||||||
|
|
||||||
Upgrade tips
|
Upgrade tips
|
||||||
------------
|
------------
|
||||||
Upgrading Nextcloud from a Snap is just like upgrading any snap package.
|
|
||||||
For example:
|
|
||||||
|
|
||||||
sudo snap refresh nextcloud
|
By default the Nextcloud snap will automatically update to subsequent stable releases. You may however upgrade
|
||||||
|
manuially too by issuing the command:
|
||||||
|
|
||||||
|
``sudo snap refresh nextcloud``
|
||||||
|
|
||||||
Your Snap package manager only upgrades the current Nextcloud Snap. Then
|
If the upgrade fails you can easily revert to the last working version by issuing the command:
|
||||||
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
|
``sudo snap revert nextcloud``
|
||||||
: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::
|
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>`_.
|
||||||
|
|
||||||
sudo nextcloud.occ upgrade
|
|
||||||
|
|
||||||
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<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
|
|
||||||
|
|
||||||
You'll find previous Nextcloud releases in the `Nextcloud Server Changelog
|
|
||||||
<https://nextcloud.com/changelog/>`_.
|
|
||||||
|
|
||||||
If upgrading via your Snap package manager fails, then you must perform a
|
|
||||||
:doc:`manual_upgrade`.
|
|
||||||
|
|||||||
Reference in New Issue
Block a user