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:
tar to backup the config folder.
sudo tar -cpzvf ~/nextcloud-config.tar.gz config/
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
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.
Refresh admin page. You shall see Nextcloud 11.0.0 is available. Click
NextCloud will be put into maintenance mode and prepare itself for upgrade.
In this step, you may see this error:
The following extra files have been found: .well-know
You can backup these “extra” files, delete them and retry update. Once the update is finished, put these files back.
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.
If you choose No, then you will be redirected to NextCloud home page and presented with the following screen. Click
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
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.