Nextcloud plugin manual upgrade process

Recently when trying to upgrade Nextcloud plugins via the web UI, I keep getting the error

An error occurred during the request. Unable to proceed.

Similarly, trying to upgrade using occ on the command line fails with

plugin_name new version available: x.y.z
plugin_name couldn't be updated.

So far I’ve been unable to determine the underlying cause, but luckily it’s still possible to upgrade manually. Here’s how.

  1. Visit the plugin’s website via the link in Nextcloud. This is usually a Nextcloud page for official plugins, or a GitHub page for third party ones. Find the Releases page and download the tarball of the latest release. Repeat for each plugin that needs upgrading.
  2. Turn maintenance mode on with occ maintenance:mode --on
  3. Remove the old plugin folder (or move it out of the Nextcloud folder if you want to keep a backup)
  4. Extract tarball the tarball in place of the old folder.
  5. Change the permissions on the extracted folder to match the rest of your installation.
  6. Run upgrade with occ upgrade
  7. Disable maintenance mode with occ maintenance:mode --off
  8. Remove the tarballs from the Nextcloud install folder (if you put them there) because they tend to interfere with core updates.

Add new comment

CAPTCHA