Updating to 10

How to update your Nextcloud from version 9.53 to 10.0

Et voila, the first upgrade to a new major version is necessary. Yesterday the Nextcloud team released Version 10 with plenty of new and shiny features. Everything will get better, faster and more secure. (Release announcement – Secure, Monitor and Control your data with Nextcloud 10 – get it now!). Thank you for that!

How to upgrade?

What has changed is the version of Nextcloud server. The iOS app works with both versions well (9.x and 10.0).

So how to upgrade the server?

A first look in the admin dashboard tells me, that there is no update available and my version is up to date.

Nextcloud 9.53 - Updater
Nextcloud 9.53 – Updater

I know it better because I read the release announcement and they say there is a new version! The sad truth is that the Updater in Nextcloud 9.53 doesn’t work. Unfortunately it is not possible to upgrade to the next version via a button click! The Updater will be fixed as soon as possible and I know it is a lot of work but for me and my personal cloud it will be a challenge.

Upgrade on shared hosting

As you know, I’m running my Nextcloud on a shared host and I installed it via the amazing web installer. Because of the broken Updater I have to do the Manual Nextcloud Upgrade as described in the documentation. The general workflow is the following:

  1. Backup files and the database is in general a very good idea!
  2. Move all Nextcloud files to a backup directory or simply rename the Nextcloud directory to [name]_old.
    Don’t forget to backup/save and copy back your data directory (see first comment from Luke).
  3. Download and unpack the new Nextcloud files in the [name] folder.
  4. Copy the /config/config.php file from your saved version to the new version

Depending on you hosting environment you can copy the files via command line, FTP or a tool like cPanel.

Now access your Nextcloud in a browser. The installer will show the database update screen. Click the Start Update button.

Nextcloud 10 - Database Update
Nextcloud 10 – Database Update

Plenty of update steps will be shown

Updating to 10
Updating to Version 10.0

and … your done! That’s it! You will be redirected to the login screen.

Have you noticed? The form fields are shaking if you try to login with wrong credentials

In the admin area you can check the Nextcloud version … and … it’s Nextcloud 10 – congrats!

Nextcloud Version 10
Nextcloud Version 10

Don’t forget to delete the old files and hopefully this was the last time that we have to do an upgrade like this :)

And now take a bit time to read the release announcement – Secure, Monitor and Control your data with Nextcloud 10 – get it now! and play around.

tl;dr: The upgrade from Nextcloud version 9.53 to 10.x works well!



, , ,



14 responses to “How to update your Nextcloud from version 9.53 to 10.0”

  1. Luke Avatar

    alright, thanks for the short manual!
    you say, “Copy the /config/config.php file from your saved version to the new version”
    may you should add “copy your /data from you saved version back to the new one too”
    Unless your data are stored outside the nextcloud.

    1. Hagen Graf Avatar

      Luke, thanks a lot for the comment. In my installation for the photos the data directory was inside the Nextcloud directory. But it’s a good idea for a future blog post to talk about “Where to put your data”!

  2. info@shwebstart.de Avatar

    What about in Nextcloud 9.53 already installed apps like Calendar and Apps and their data? Have to be installed again in 10.0 ?

    1. Hagen Graf Avatar

      As far as I know they will be updated automatically.

  3. percy Avatar

    Hey thanks for the ost. Everything works fine but after copying the old config-file to new nextcloud the code-integrity don’t agree with it. what should be done there?

    1. Hagen Graf Avatar

      In the message concerning code integrity is a link to the list of files that are not shipped by Nextcloud 10. They are not needed so you can delete them.

  4. percy Avatar

    ahh okay – so now i’ve checked the structure again and ’ve found onother config-file in the root-path – no idea how this became in there. deleted and now it’s allright – thanks!

  5. Wolfgang H. Avatar

    Thanks for the documentation. At first try i had an error while upgrading. After setting config.php maintenance to “false” and retry it, it worked well. You know what happened with the status.php file, which i monitored with Icinga2 (https:​//cloud.​xyz.xyz/status.​php)? https://docs.nextcloud.com/server/10/admin_manual/operations/considerations_on_monitoring.html


  6. Martin Avatar

    Hello Hagen,

    thank you for this helpful tutorial.

    For all hosting at HostEurope via SSL I like to leave my way I did it:

    All try to upload the Files with Hosteurope FTP or FileZilla failed!!!!

    Within WIN10 I simply added a new networkaddress to my FTP account at Hosteurope.

    1. Locally I unzipped the downloaded Nextcloud10 Zip installation file
    2. I copied the old config.php file into this nextcloud/config path (see below)
    3. Within .htaccess I added following lines for HTTPS access after “RewriteEngine on”

    RewriteCond {0f2b36d8f80fa52f37b916148a6e37fe671d96583f68d5887344addd2eee52a6}{HTTP:Via} !ssl.webpack.de
    RewriteRule ^ https://ssl.webpack.de/{0f2b36d8f80fa52f37b916148a6e37fe671d96583f68d5887344addd2eee52a6}{HTTP_HOST}{0f2b36d8f80fa52f37b916148a6e37fe671d96583f68d5887344addd2eee52a6}{REQUEST_URI} [R=301,L]

    After reload of cloud within MS Edge, the update of DB started and finally I had to reactivate some apps (Contacts, Calendar, FilesMove etc.)

    Due to my change in .htaccess I get a code integrity check hint. Here I do not know how to accept this change within system. Any idea to fix this last point?

    Martin from Bavaria


    config.php for SSL at hosteurope:

    $CONFIG = array (
    ‘instanceid’ => ‘xxxxxxxxxx’,
    ‘passwordsalt’ => ‘xxxxxxxxxxxxxx’,
    ‘secret’ => ‘xxxxxxxxxx’,
    ‘trusted_domains’ =>
    array (
    0 => ”,
    1 => ‘ssl.webpack.de’,
    ‘overwritehost’ => ‘ssl.webpack.de’,
    ‘overwriteprotocol’ => ‘https’,
    ‘overwritewebroot’ => ”,
    ‘datadirectory’ => ‘your data directory located at hosteurope’,
    ‘overwrite.cli.url’ => ‘http://’,
    ‘dbtype’ => ‘mysql’,
    ‘version’ => ‘’,
    ‘dbname’ => ‘dbxxxxxxx-nc’,
    ‘dbhost’ => ‘localhost’,
    ‘dbtableprefix’ => ‘oc_’,
    ‘dbuser’ => ‘dbxxxxxxx-nc’,
    ‘dbpassword’ => ”,
    ‘logtimezone’ => ‘UTC’,
    ‘installed’ => true,
    ‘updater.release.channel’ => ‘stable’,
    ‘appstore.experimental.enabled’ => true,

    1. Luke Avatar

      Hi Martin,

      i have the same “problem” with the integrity check hint. My Nextcloud is also hosted by HostEurope!
      I didn’t have any problems with the upload, but the integrity check hint bothers me too.

      I have add to my .htaccess at the top following code:
      RewriteEngine On
      RewriteCond {0f2b36d8f80fa52f37b916148a6e37fe671d96583f68d5887344addd2eee52a6}{SERVER_PORT} !=443
      RewriteRule (.*) https://mydomain.com/nextcloud/$1 [R=301,L]
      Header set Strict-Transport-Security “max-age=31536000” env=HTTPS

      Has anyone an Idea what to do?

  7. Konstantin Avatar

    Hi Hagen.
    Thanks for tutorial, but I’ve a question. After copy file config.php from old directory and start web server I see this message:
    “update Required

    Please use the update from the command line, as this setting is large. ”

    Can you help me in this question?

    1. Hagen Graf Avatar

      Hi Konstantin, i’m not so deep into details but try the way described in the Nextcloud documentation https://docs.nextcloud.com/server/10/admin_manual/maintenance/update.html#updater-cli-label

      1. Konstantin Avatar

        Thanks for answer. I find mistake:
        after copy file and start web server I start command line script to upgrade application.
        It’s works now!))

Leave a Reply

Leave a Reply