Upgrade-procedure.md

 ### faircloud upgrade procedure
 
-This is an internal documentation for fairkom sysadmins. 
+This is an internal documentation for fairkom sysadmins. We have to upgrade nextcloud every few months.
 
+1. announce maintenance with Announcement app
 1. in /var/www/nextcloud/config/config.php set `'maintenance' => true,`
 1. do a manual DB backup
 1. set 'maintenance' => false,
 1. as nextcloud admin we now run upgrade to the latest minor version in the web interface
 1. `Continue with web based updater` should be fine with minor updates
 1. this usually also updates all apps, and there is no way to get back in app versions
-1. continue with upgrading to next nextcloud version
+1. check if all apps are working 
+1. continue with upgrading to next nextcloud major version with `sudo -u www-data php occ upgrade`
+1. some repair jobs may take quite long https://git.fairkom.net/hosting/nextcloud/-/issues/111#note_40870
+1. check admin settings oevrview page
+1. likely you need to do a `sudo -u www-data php occ db:add-missing-indices`
 
 
 In case we need to continue completely manually, we also can change the Alias to maintenance in `/etc/apache2/sites-available/nextcloud.conf`