diff --git a/admin_manual/maintenance/upgrade.rst b/admin_manual/maintenance/upgrade.rst
index 390d06e15..fc0e82ed8 100644
--- a/admin_manual/maintenance/upgrade.rst
+++ b/admin_manual/maintenance/upgrade.rst
@@ -211,9 +211,23 @@ Now you can review your third-party apps, and upgrade and enable them.
 Troubleshooting
 ---------------
 
-Occasionally, files do not show up after a upgrade. A rescan of the files can help::
+Occasionally, *files do not show up after a upgrade*. A rescan of the files can help::
 
  $ sudo -u www-data php console.php files:scan --all
 
 See `the owncloud.org support page <http://owncloud.org/support>`_ for further
 resources for both home and enterprise users.
+
+Sometimes, ownCloud can get *stuck in a upgrade*. This is usually due to the process taking too long and encountering a time-out. It is recommended to turn of the upgrade and start over with the manual process from the command line as described above under point 12.
+
+Stop the upgrade process this way::
+
+     $ sudo -u www-data php occ maintenance:mode --off
+  
+And start the manual process::
+  
+    $ sudo -u www-data php occ upgrade
+
+If this does not work properly, try the repair function::
+
+    $ sudo -u www-data php occ maintenance:repair