mirror of
https://github.com/nextcloud/documentation.git
synced 2026-01-04 10:46:21 +07:00
84 lines
3.9 KiB
ReStructuredText
84 lines
3.9 KiB
ReStructuredText
===================================
|
|
How to Upgrade Your ownCloud Server
|
|
===================================
|
|
|
|
There are three ways to upgrade your ownCloud server:
|
|
|
|
* Using your :doc:`Linux package manager <package_upgrade>` with our official
|
|
ownCloud repositories. This is the recommended method.
|
|
* With the :doc:`Updater App <update>` (Server Edition only). Recommended for
|
|
shared hosters, and for users who want an easy way to track different
|
|
release channels. (It is not available and not supported on the Enterprise
|
|
edition.)
|
|
* :doc:`Manually upgrading <manual_upgrade>` with the ownCloud ``.tar`` archive
|
|
from `owncloud.org/install/`_.
|
|
* Manually upgrading is also an option for users on shared hosting; download
|
|
and unpack the ownCloud tarball to your PC. Delete your existing ownCloud
|
|
files, except ``data/`` and ``config/`` files, on your hosting account. Then
|
|
transfer the new ownCloud files to your hosting account, again
|
|
preserving your existing ``data/`` and ``config/`` files.
|
|
|
|
When an update is available for your ownCloud server, you will see a
|
|
notification at the top of your ownCloud Web interface. When you click the
|
|
notification it brings you here, to this page.
|
|
|
|
**It is best to keep your ownCloud server upgraded regularly**, and to install
|
|
all point releases and major releases without skipping any of them, as skipping
|
|
releases increases the risk of errors. Major releases are 8.0, 8.1, 8.2, and
|
|
9.0. Point releases are intermediate releases for each major release. For
|
|
example, 8.0.9 and 8.1.3 are point releases. **Skipping major releases is not
|
|
supported.**
|
|
|
|
**Upgrading is disruptive**. Your ownCloud server will be put into maintenance
|
|
mode, so your users will be locked out until the upgrade is completed. Large
|
|
installations may take several hours to complete the upgrade.
|
|
|
|
.. warning:: **Downgrading is not supported** and risks corrupting your data! If
|
|
you want to revert to an older ownCloud version, make a new, fresh
|
|
installation and then restore your data from backup. Before doing this,
|
|
file a support ticket (if you have paid support) or ask for help in the
|
|
ownCloud forums to see if your issue can be resolved without downgrading.
|
|
|
|
.. not sure about notifications
|
|
.. Update Notifier and Updater App Are Not the Same
|
|
.. ------------------------------------------------
|
|
|
|
.. ownCloud has two update tools: the ownCloud core update notifier, and the
|
|
.. Updater app. Figure 1 shows what you see when the Updater app is enabled:
|
|
.. both
|
|
.. the core notifier and the Updater app control panel are visible on your
|
|
.. admin
|
|
.. page.
|
|
|
|
.. .. figure:: images/2-updates.png
|
|
.. :alt: Both update mechanisms displayed on Admin page.
|
|
|
|
.. *Figure 1: The top yellow banner is the update notifier, and the Updates
|
|
.. section is the Updater app.*
|
|
|
|
.. The core update notifier has only one function, and that is to display a
|
|
.. notification when a new ownCloud release is available. Then you decide which
|
|
.. upgrade method to use. When you maintain your ownCloud server via your Linux
|
|
.. package manager you should ensure that the Updater app is disabled.
|
|
|
|
Prerequisites
|
|
-------------
|
|
|
|
You should always maintain :doc:`regular backups <backup>` and make a fresh
|
|
backup before every upgrade.
|
|
|
|
Then review third-party apps, if you have any, for compatibility with the new
|
|
ownCloud release. Any apps that are not developed by ownCloud show a 3rd party
|
|
designation. **Install unsupported apps at your own risk**. Then, before the
|
|
upgrade, all 3rd party apps must be disabled. After the upgrade is complete you
|
|
may re-enable them.
|
|
|
|
Debian Migration to Official ownCloud Packages
|
|
----------------------------------------------
|
|
|
|
As of March 2016 Debian will not include ownCloud packages. Debian users can
|
|
migrate to the official ownCloud packages by following this guide,
|
|
`Upgrading ownCloud on Debian Stable to official packages
|
|
<https://owncloud.org/blog/upgrading-owncloud-on-debian-stable-to-official-
|
|
packages/>`_.
|