How to upgrade Nextcloud

nextcloudNew versions of Nextcloud are released on a regular basis.  This article describes how to upgrade to the latest version (I'm using Nextcloud 18 at the time of writing).


Apps

Before upgrading Nextcloud, we will check for any updates to our installed apps.

  1. Start by logging in with an admin account.
  2. Click your Avatar > Apps.
  3. Select Updates in the left pane (only visible if updates are available).
  4. Click the Update button for individual apps, or Update all.

Note that if you don't update Apps in this step, they should be updated as part of the process below.

 

Locked files

It's also a good time to see if there are any files that have been locked but not reported.

 

Built-in Updater

Nextcloud has its own built-in updater. The update process includes checking for any 'unknown' files or folders. You will need to remove any that are discovered before the upgrade can go ahead.

  1. Go to the Settings page (click your avatar, top-right).
  2. Select Administration > Overview in the left pane.
  3. Check to see if All apps have update for this version available.
  4. Click the Open updater button.
  5. Click Start update.
  6. Click the No (for usage of the web based updater) button.
  7. Click Go back to your Nextcloud instance to finish the update.
    1. Make a note of information on this screen.
  8. Click the Start update button to apply the update to your database.

 

Tidying up

If you are using a theme, you will need to edit the config/config.php file in order to reinstate it. Additionally the .htaccess file gets overwritten as part of the upgrade process, so you will need to add in the settings to force SSL.

The default favicon at /core/img/favicon.ico will get overwritten and don't forget to move back any files or folders that you might've removed as part of the upgrade process.

This upgrade process creates a backup directory that you can visit and remove any older backups that you no longer need. Depending on your instance, these backup directories can take up a considerable amount of space.

/data/updater=xxxxxxxx/backups/

 

Thanks for visiting.