# HG changeset patch
# User Alexandr Tanayno <atanayno@gitlab.com>
# Date 1692074106 0
#      Tue Aug 15 04:35:06 2023 +0000
# Node ID d1adc5d613c982ea88f948a547a88f8311013e7b
# Parent  754e15c9cfb0d05403fdd9dbea29d883f6d4047b
Add section about stuck reconfigure during re-installation

diff --git a/doc/installation/index.md b/doc/installation/index.md
--- a/doc/installation/index.md
+++ b/doc/installation/index.md
@@ -115,6 +115,7 @@
      sudo systemctl disable gitlab-runsvdir
      sudo rm /usr/lib/systemd/system/gitlab-runsvdir.service
      sudo systemctl daemon-reload
+     sudo systemctl reset-failed
      sudo gitlab-ctl uninstall
      ```
 
diff --git a/doc/troubleshooting.md b/doc/troubleshooting.md
--- a/doc/troubleshooting.md
+++ b/doc/troubleshooting.md
@@ -820,6 +820,17 @@
 
 Refer to [issue 341573](https://gitlab.com/gitlab-org/gitlab/-/issues/341573) for more details.
 
+## Reconfigure is stuck when re-installing GitLab
+
+Because of a [known issue](https://gitlab.com/gitlab-org/omnibus-gitlab/-/issues/7776), you can see the reconfigure process stuck at
+`ruby_block[wait for logrotate service socket] action run` after uninstalling GitLab and trying to install it again. This problem occurs when one of the `systemctl` commands are
+not executed when [uninstalling GitLab](installation/index.md#uninstall-the-linux-package-omnibus).
+
+To resolve this issue:
+
+- Make sure you followed all the steps when uninstalling GitLab and perform them if necessary.
+- Follow the workaround in [issue 7776](https://gitlab.com/gitlab-org/omnibus-gitlab/-/issues/7776).
+
 ## Mirroring the GitLab `yum` repository with Pulp or Red Hat Satellite fails
 
 Direct mirroring of the Omnibus GitLab `yum` repositories located at <https://packages.gitlab.com/gitlab/> with [Pulp](https://pulpproject.org/) or