Skip to content

Update package_upgrade.rst #12925

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Mar 26, 2025
Merged

Update package_upgrade.rst #12925

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
1b02cbb
Update package_upgrade.rst
scubamuc Mar 24, 2025
6d5750a
Update package_upgrade.rst
scubamuc Mar 26, 2025
3375a92
Update package_upgrade.rst
scubamuc Mar 26, 2025
09a1259
Update package_upgrade.rst
scubamuc Mar 26, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
101 changes: 24 additions & 77 deletions admin_manual/maintenance/package_upgrade.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
====================
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Line is too short. Add "====="

Upgrade via packages
Upgrade via snap packages
====================
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Line is too short. Add "====="


Upgrade quickstart
Expand All @@ -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 <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
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 <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 `<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,
`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 ``<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,
``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 <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.
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<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
<https://nextcloud.com/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 <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>`_.