Upgrade ownCloud From Packages
Upgrade Quickstart
The alternative to a manual upgrade is configuring your system to use ownCloud’s Open Build Service repository. Then stay current by using your Linux package manager to install fresh ownCloud packages. After installing upgraded packages you must run a few more steps to complete the upgrade. These are the basic steps to upgrading ownCloud:
-
Disable all third-party apps.
-
Make a fresh backup.
-
Upgrade your ownCloud packages.
-
Run occ upgrade
The optional parameter to skip migration tests was removed in ownCloud 10.0. See Testing a Migration for background information. -
Apply strong permissions to your ownCloud directories.
-
Take your ownCloud server out of maintenance mode.
-
Re-enable third-party apps.
If required, you can skip major releases when upgrading your ownCloud installation. However, we recommend that you first upgrade to the latest point release of your respective minor version, e.g. 8.2.11. See Upgrading Across Skipped Releases for more information. If you are on ownCloud 8.2.11, 9.0.9 or 9.1.X, you can go directly to the latest server version. Here are some examples:
|
When upgrading from oC 9.0 to 9.1 with existing Calendars or Address books please have a look at the release notes for important information about the needed migration steps during that upgrade. |
Upgrade Tips
Upgrading ownCloud from our Open Build Service repository is just like any normal Linux upgrade. For example, on Debian or Ubuntu Linux this is the standard system upgrade command:
apt-get update && apt-get upgrade
Or you can upgrade just ownCloud with this command:
apt-get update && apt-get install owncloud-files
On Fedora, CentOS, and Red Hat Linux use yum
to see all available
updates:
yum check-update
You can apply all available updates with this command:
yum update
Or update only ownCloud:
yum update owncloud-files
Your Linux package manager only downloads the current ownCloud packages. Then your ownCloud server is immediately put into maintenance mode. You may not see this until you refresh your ownCloud page.
Then use occ
to complete the upgrade. You must run occ
as your HTTP
user. This example is for Debian/Ubuntu:
sudo -u www-data php occ upgrade
This example is for CentOS/RHEL/Fedora:
sudo -u apache php occ upgrade
The optional parameter to skip migration tests during this step was removed in ownCloud 10.0.
See Testing a Migration for background
information, and Using the OCC command to learn more about occ .
|
Setting Strong Directory Permissions
After upgrading, verify that your ownCloud directory permissions are set accordingly.
Upgrading Across Skipped Releases
It is best to update your ownCloud installation with every new point release (e.g., 8.1.10), and to never skip any major release (e.g., don’t skip 8.2.x between 8.1.x and 9.0.x). If you have skipped any major release you can bring your ownCloud current with these steps:
-
Add the repository of your current version (e.g., 8.1.x)
-
Upgrade your current version to the latest point release (e.g., 8.1.10) via your package manager
-
Run the
occ upgrade
routine (see Upgrade Quickstart above) -
Add the repository of the next major release (e.g., 8.2.x)
-
Upgrade your current version to the next major release (e.g., 8.2.8) via your package manager
-
Run the
occ upgrade
routine (see Upgrade Quickstart above) -
Repeat from step 4 until you reach the last available major release (e.g., 9.1.x)
You’ll find repositories of previous ownCloud major releases in the ownCloud Server Changelog.