How to Upgrade Your ownCloud Server

Introduction

We recommend that you keep your ownCloud server up to date. 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 will bring you here.

Before beginning an upgrade, please keep the following points in mind:

  • Review the release notes for important information about the needed migration steps during that upgrade to help ensure a smooth upgrade process.

  • Check ownCloud’s mandatory requirements (such as PHP versions and extensions), which can change from one version to the next. Ensure that you review them and update your server(s), if required, before upgrading ownCloud.

  • Upgrading is disruptive, as your ownCloud server will be put into maintenance mode.

  • Large installations may take several hours to complete the upgrade.

  • Review any installed third-party apps for compatibility with the new ownCloud release.

  • Downgrading is not supported as it 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 resolve your issue without downgrading.

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:

Version Can Upgrade to 10.2.1? Requirements

8.2.11

Yes

8.2.10

No

Must upgrade to 8.2.11 first.

9.0.9

Yes

9.0.8

No

Must upgrade to 9.0.9 first.

9.1.8

Yes

9.1.0

Yes

7.0.15

No

Must upgrade to 8.0.x, then to 8.1.x, and then to 8.2.11 first.

7.0.10

No

Must upgrade to 7.0.15, then to 8.0.x, then to 8.1.x, and then to 8.2.11 first.

Prerequisites

We strongly recommend that you always maintain regular backups as well as make a fresh backup before every upgrade. We also recommend that you review any installed third-party apps for compatibility with the new ownCloud release. Ensure that they are all disabled before beginning the upgrade. After the upgrade is complete re-enable any which are compatible with the new release.

Unsupported apps may disrupt your upgrade.

Upgrade Options

There are two ways to upgrade your ownCloud server:

  1. (Recommended) Perform a manual upgrade, using the latest ownCloud release.

  2. (Discouraged) Use your distribution’s package manager, in conjunction with our official ownCloud repositories. Note: This approach should not be used unattended nor in clustered setups. We discourage upgrades with Linux Package Manager because you might encounter unwanted side effects.

Enterprise customers: refer to Installing & Upgrading ownCloud Enterprise Edition for more information.