How to Update Nextcloud on Unraid

I’ve had zero luck using the built-in updater to update versions of Nextcloud on unraid. Following SpaceInvaderOne’s video didn’t help. I was always getting stuck at Step 3 and have to remember how to get Nextcloud to forget that it’s stuck there (hint, in your Nextcloud directory there’s a folder “updater-{randomstring}”. In that directory, there’s a “.step” file: delete that file).

I can’t credit the source for how I found this solution, but this is how I go about updating Nextcloud on Unraid:

Navigate to the Docker tab in Unraid WebUI, click on the Nextcloud container icon, and select the console. Then do the following:

sudo -u abc php /config/www/nextcloud/updater/updater.phar

Then just follow the prompts. This should prompt you to perform the upgrade (Y) and ask if you want to keep maintenance mode active (N). If not, once the updater is complete, do the following.

sudo -u abc php /config/www/nextcloud/occ upgrade
sudo -u abc php /config/www/nextcloud/occ maintenance:mode --off

Hopefully that’s helpful. You will have to step through each major version release like this until you are at the most recent version. For example, I was running 18.0.6, so in order to update to 20.0.1, I had to upgrade to 18.0.10, then 19.0.4, then 20.0.1.

Manually add files to the Nextcloud database

Side note: here’s how to manually add files to the Nextcloud directory and have them scanned into the Nextcloud db:

sudo -u abc php /config/www/nextcloud/occ files:scan --all

Fixing errors and warnings

After upgrading, navigate to Settings -> Administration/Overview and check the Security & setup warnings. Typically these will give a resolution. The trick on Unraid is to again, launch a console from the Docker tab, and adding

sudo -u abc php /config/www/nextcloud/

in front of the occ commands that are given.