How to Upgrade to NextCloud 11 From NextCloud 10 With the Updater App

NextCloud 11 was released on December 13, 2016. In this tutorial, we’re going to look at how to upgrade to NextCloud 11 using the updater app, which automates many steps of a manual upgrade.

Notable changes and improvements in NextCloud 11 includes:

  • Introduces significant security improvements, attested by NCC Group.
  • Decreases database load by up to 80% and improves response time by up to 60% for common server operations
  • Apache Solr powered Full Text Search
  • A new app store
  • Spreed WebRTC video chats integration.
  • And more.

For more details about this release, please go to Nextcloud official site. Before updating, make sure that the NextCloud database, config folder and data directory are backed up.

Backing Up NextCloud Database

To backup NextCloud database, first you need to find out the database name by running the following command on your NextCloud server.

mysql -u root -p -e "show databases"

Enter the password of MariaDB/MySQL root user. You will see something like below:

| Database           |
| information_schema |
| mysql              |
| nextcloud          |
| performance_schema |

As you can see, my NextCloud database name is nextcloud. Once you have identified the NextCloud database name, use mysqldump utility to make a backup like below. Replace red text with your own NextCloud database name.

mysqldump -u root -p nextcloud-database-name > ~/nextcloud.sql

The above command creates a dump file (nextcloud.sql) under your home directory and it can be used to restore Nextcloud database if any disastrous things happen.

Backing Up NextCloud Config Folder

To back up NextCloud config folder, first cd into Nextcloud installation directory such as:

cd /var/www/nextcloud/

Then use tar to backup the config folder.

sudo tar -cpzvf ~/nextcloud-config.tar.gz config/

Because config.php file is read only by web server, so we have to add sudo. The backup file (nextcloud-config.tart.gz) will be placed under your home directory.

Backing Up NextCloud Data Directory

The data directory contains all files (texts, images, audios, videos, etc) uploaded by users. To find out the where data directory is, you can open up the config.php file.

sudo nano /var/www/nextcloud/config/config.php

The datadirectory line specifies the location of data directory. Once you have found it, use tar to back it up.

sudo tar -cpvzf ~/nextcloud-data.tar.gz /path/to/nextcloud-data/

Please note that it’s best to place data directory outside of NextCloud installation to keep it secure.

How to Upgrade to NextCloud 11 Using Updater App

Now that all is backed up, let’s upgrade NextCloud.

Go to NextCloud admin page, scroll down to the bottom. You may be notified that NextCloud installation is up to date, despite the fact that you are using NextCloud 10. That’s because NextCloud 11 hasn’t been pushed into the stable update channel of the Updater app. You have to wait for 1 – 2 weeks.

If you are eager to give NextCloud 11 a try, then you can change update channel from stable to beta.

nextcloud 10 upgrade

Refresh admin page. You shall see Nextcloud 11.0.0 is available. Click Open updater.

nextcloud 11 upgrade

Then click start update.

upgrade nextcloud 10 to 11


NextCloud will be put into maintenance mode and prepare itself for upgrade.

nextcloud upgrade

In this step, you may see this error:

The following extra files have been found:


You can backup these “extra” files, delete them and retry update. Once the update is finished, put these files back.

If the download failed because of 504 gateway timeout error, then you need to restart PHP-FPM.

sudo systemctl restart php7.4-fpm

Once this step is complete, you have the option to keep maintenance active or disable maintenance mode. If you have a large NextCloud installation (many users and files), then it’s recommended to select Yes and use command line to update NextCloud. If your NextCloud installation is small, you can choose No and use the web-based updater.

nextcloud maintenance mode

If you choose No, then you will be redirected to NextCloud home page and presented with the following screen. Click Start Update.

nextcloud 11 update

The update time varies depending on your installation size. In my case, it finished in a few seconds. Once the update is complete, go to admin page and you shall see the version has been changed to NextCloud 11.0.0.

If you choose Yes in the previous step, then you need to go into NextCloud installation directory and issue a command to start the upgrade.

cd /var/www/nextcloud/

sudo -u www-data php occ upgrade

www-data is the username of web server, which may be different on your system. It’s commonly named www-data, nginx, http. Once the upgrade is complete, disable maintenance mode with:

sudo -u www-data php occ maintenance:mode --off

Go to admin page and you shall see the version has been changed to NextCloud 11.0.0.

Don’t forget to re-enable 3rd party apps after upgrade.

That’s all you need to do in order to upgrade to Nextcloud 11. As always, if you found this post useful, then subscribe to our free newsletter. You can also follow us on Google+ Twitter or like our Facebook page.

Rate this tutorial
[Total: 13 Average: 4.2]

Leave a Comment

  • Comments with links are moderated by admin before published.
  • Your email address will not be published.
  • Use <pre> ... </pre> HTML tag to quote the output from your terminal/console.
  • Please use the community ( for questions unrelated to this article.
  • I don't have time to answer every question. Making a donation would incentivize me to spend more time answering questions.

The maximum upload file size: 2 MB. You can upload: image.