Upgrading to ownCloud Server 8.2

ownCloud Server 8.2 was released yesterday with a much improved user interface and many new admin goodies! It is time to start thinking about upgrading and this blog post aims to tell you everything you need to know. Note that there’s a change in location for the Linux Packages, be sure to carefully read what’s going on there.

Why Should I Upgrade?

ownCloud Server 8.2 introduces many smaller and larger improvements all over ownCloud, from the redesigned user interface with the new sidebar and rewritten Gallery app to many new capabilities for administrators to configure and control ownCloud. You can find out more about what is new in our announcement blog and see a full overview on the website.

If you would like the benefit of these improvements then it’s time for you to move to ownCloud 8.2!


Before you upgrade, be sure to carefully read the ownCloud 8.2 release notes. It is very important to note, for example, these things:

  • filesystem_check_changes in config.php is set to 0 by default. This prevents unnecessary update checks and improves performance. If you are using external storage mounts such as NFS on a remote storage server, set this to 1 so that ownCloud will detect remote file changes.
  • XSendFile support has been removed, so there is no longer support for serving static files from your ownCloud server. It does not work with our new High Level File Locking capability (which protects against certain race conditions).

ownCloud updater app
ownCloud updater app in action

There are more important changes like these so give the release notes a good read.

Be sure that you have the base requirements for ownCloud 8.2:

  • A Linux or BSD server (Mac OS X is possible but less tested)
  • MySQL 5.5 + / MariaDB 10.x
  • PHP 5.4 +
  • Apache 2.4 +

There are other web servers (like Ngnix) and databases (like PostgreSQL) supported as well.

Usually, newer versions mean better performance with ownCloud. This is especially true for PHP. If you use ownCloud with other web servers like Ngnix or on platforms like a NAS, be sure to have an extra careful look at the documentation!

Not all ownCloud apps developed for and on earlier releases are yet modified to work with ownCloud 8.2, so we urge you to check if your favorite apps are already compatible with ownCloud 8.2. You can usually check on the online ownCloud app overview.

Upgrading ownCloud
Upgrading ownCloud

When it comes to stability and potential upgrade issues, we always urge users to test ownCloud Betas before of the release and to report any bugs you come across. Only a test on your specific circumstances can tell you if a piece of software will work for you. However, ownCloud 8.2 has seen significant testing, including by using our automated Smashbox testing, a tool developed by CERN. We are therefore very confident in the stability of this release.

We still strongly recommend to make a backup of your database and data. You can find instructions on how to do that here.

Tips in the admin settings
Tips in the admin settings

The Upgrade Itself

We have written a great guide on upgrading ownCloud in our documentation. Carefully read the document, make the appropriate choices about how you will upgrade (with packages, manually or the updater app), and proceed with the steps described.

Note that if you wish to use the updater app, we usually release a new major ownCloud version for the updater app within a week after the release, provided no big problems are found, so this is currently not yet available. If we notice serious upgrade issues we will delay the automatic update until we released the first maintenance update.


With regard to Linux Packages, there are two major changes.

  • First of all, from now on, packages will appear on download.owncloud.org. For ownCloud 8.2 you can find them on this page. You will find the familiar installation instructions for our supported Linux distributions there.

    If you are currently using the Stable release channel, you will have to manually change over to this new repository!
  • Second, the Linux packages will show a different upgrade behavior. Linux packages before 8.2 send an existing ownCloud server into maintenance mode, install the new code base, perform occ upgrade on behalf of the system administrator, then exit out of maintenance mode. This often came unexpected to the admin and is in general not safe as an unattended install. Third party apps are also likely to break this automated process.

    Linux packages 8.2 and up change an existing ownCloud server into maintenance mode, install the new code base, and leave the server in maintenance mode. It is up to the system administrator to finalize the upgrade.


While we strive to keep managing ownCloud as easy as possible (including the upgrade procedure!) and test as many upgrade scenarios, the documentation contains a troubleshooting section with instruction on how to recover from the most typical problems.

If this does not help you, there is a support page on owncloud.org which links to the various resources available to you. Home users should check out the forums, which have a special section devoted to ownCloud 8.2 upgrades with excellent and up to date information. Professional users can find resources on owncloud.com and are strongly urged to wait with the upgrade until the availability of the ownCloud support subscriptions. These will become available next month. It is, as usual, recommended to test this release of ownCloud Server to ensure compatibility with your infrastructure and see if the features fulfill your needs.

Fresh installations

If you currently don’t have ownCloud, there is a new and easy way to get up and running! In the Appliance tab on our download page we offer a fully pre-configured virtual machine image which you can easily run in a tool like VirtualBox. Thanks to the built in ownCloud Proxy app you can have a stable url and an easy way through firewalls blocking you from accessing your ownCloud.

Once your brand new ownCloud 8.2 is up and humming nicely, we’d appreciate it if you would let us know what you think over Twitter and other social media, see owncloud.org/promote for more.

Enjoy ownCloud Server 8.2!

18 Responses to “Upgrading to ownCloud Server 8.2”

  1. Leo

    Upgraded to 8.2 without a hitch. But, now when ever I attempt to open a .doc, .txt etc I get a popup window that has a white background and smaller font, which is okay, but now I’m unable to search the document for individual words? What happened to the “search”, “clear” and “next” tabs???? An F3 window will simply continue to search the database behind the popup window but doesn’t search the open txt document…… Anyone know how to work around this? Thanks

    • Chris

      Check the issue tracker of the documents app and avoid posting support questions in such blogposts.

  2. Tom


    I have 3 owncloud deployments and in 2 of them I was able to update to 8.2 with update tool under administration menu, but in the third one 8.2 still unavailable with stable channel. is it normal that in some servers I’m able to update and in others I don’t?

  3. xela


    oc update app shows me the update … but still no update over apt.

  4. Alex

    Still no update via update app. Have I got a problem or do I just have to wait some more days?

  5. Albert

    I, right now, I installed version 8.1.1, with Xsendfile activated. As I read, Xsendfile support disappears in 8.2, by High Level File Locking capability, but I’ve read in several forums that Xsendfile need to serve well the videos I have hosted on the server, specifically so that they have the the possibility of video playback. If I upgrade, the videos will be as before? Will the performance be affected? Could be a dummy question, but I don’t know to what extent it affects the update.

    System software specs installed:

    Ubuntu 14.04 LTS x64.
    Apache Server 2.4.7.
    MySQL Server 5.5.
    PHP 5.5.9.
    Owncloud 8.1.1 (Stable).

    Thank you.


    • Albert

      dumb question* sorry about that.

    • Chris

      Its probably better to ask such questions at the forums or the users mailinglist rather than in the comments of a release.

  6. Alex

    When will the updater app show the update? Thanks

  7. Karmashkin

    Yes, new version is production ready. Thnx ownCloud group.

  8. Chris

    Just a short note to the new repositories. Some systems might need the package:


    according to https://github.com/owncloud/core/issues/19961

Comments are closed.