diff --git a/doc/update/convert_to_omnibus.md b/doc/update/convert_to_omnibus.md
index 6c560bbc963af081786dfa9f7f10d2f99348fe9c_ZG9jL3VwZGF0ZS9jb252ZXJ0X3RvX29tbmlidXMubWQ=..be46b88d509bb3dd9b7a66ee7ddc36664eb1cc05_ZG9jL3VwZGF0ZS9jb252ZXJ0X3RvX29tbmlidXMubWQ= 100644
--- a/doc/update/convert_to_omnibus.md
+++ b/doc/update/convert_to_omnibus.md
@@ -77,9 +77,15 @@
 
 1. Reconfigure Omnibus GitLab to apply the changes:
 
-    ```shell
-    sudo gitlab-ctl reconfigure
-    ```
+   ```shell
+   sudo gitlab-ctl reconfigure
+   ```
+
+1. If you migrated `/home/git/gitlab-shell/.gitlab_shell_secret`, you also [need to restart Gitaly](https://gitlab.com/gitlab-org/gitaly/-/issues/3837):
+
+   ```shell
+   sudo gitlab-ctl restart gitaly
+   ```
 
 ## Upgrading from non-Omnibus PostgreSQL to an Omnibus installation using a backup