diff --git a/docs/debug-mysql_upgrade.md b/docs/debug-mysql_upgrade.md
new file mode 100644
index 000000000..b157af3c9
--- /dev/null
+++ b/docs/debug-mysql_upgrade.md
@@ -0,0 +1,16 @@
+## Run a manual mysql_upgrade
+
+This step is usually not necessary. 
+
+```
+docker-compose stop mysql-mailcow watchdog-mailcow
+docker-compose run --rm --entrypoint '/bin/sh -c "gosu mysql mysqld --skip-grant-tables & sleep 10 && bash && exit 0"' mysql-mailcow
+```
+
+As soon as the SQL shell spawned, run `mysql_upgrade` and exit the container:
+
+```
+mysql_upgrade
+exit
+```
+
diff --git a/mkdocs.yml b/mkdocs.yml
index d6e85fd53..35ab78e9c 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -45,7 +45,8 @@ nav:
     - 'Introduction': debug.md
     - 'Logs': 'debug-logs.md'
     - 'Attach a Container': 'debug-attach_service.md'
-    - 'Reset Passwords': 'debug-reset_pw.md'
+    - 'Reset Passwords (incl. SQL)': 'debug-reset_pw.md'
+    - 'Manual MySQL upgrade': 'debug-mysql_upgrade.md'
     - 'Remove Persistent Data': 'debug-rm_volumes.md'
     - 'Common Problems': 'debug-common_problems.md'
     - 'Admin login to SOGo': 'debug-admin_login_sogo.md'