Merge branch 'axil-init-passwd' into 'master'

SSoT for initial root password

See merge request https://gitlab.com/gitlab-org/omnibus-gitlab/-/merge_requests/7064

Merged-by: Russell Dickenson <[email protected]>
Approved-by: Evan Read <[email protected]>
Approved-by: Russell Dickenson <[email protected]>
Co-authored-by: Evan Read <[email protected]>
Co-authored-by: Achilleas Pipinellis <[email protected]>

Author: 3 people

doc/installation/index.md

@@ -59,10 +59,16 @@ To provide a custom initial root password, you have two options:
 
 - Pass the `GITLAB_ROOT_PASSWORD` environment variable to the
   [installation command](https://about.gitlab.com/install/) provided
-  the hostname for the server is set up correctly.
+  the hostname for the server is set up correctly:
+
+  ```shell
+  sudo GITLAB_ROOT_PASSWORD="<strongpassword>" EXTERNAL_URL="http://gitlab.example.com" apt install gitlab-ee
+  ```
+
   If during the installation GitLab doesn't automatically perform a
   reconfigure, you have to pass the `GITLAB_ROOT_PASSWORD` variable to the
   first `gitlab-ctl reconfigure` run.
+
 - Before the first reconfigure, edit `/etc/gitlab/gitlab.rb` (create it if it
   doesn't exist) and set:
 

doc/settings/configuration.md

@@ -693,12 +693,8 @@ To add a CSP:
 
 ## Set initial root password on installation
 
-The initial password for the administrator user `root` can be set at the installation time
-with the `GITLAB_ROOT_PASSWORD` environment variable:
-
-```shell
-sudo GITLAB_ROOT_PASSWORD="<strongpassword>" EXTERNAL_URL="http://gitlab.example.com" apt install gitlab-ee
-```
+The initial password for the administrator user `root` can be set at installation time. For more information, see
+[Set up the initial password](../installation/index.md#set-up-the-initial-password).
 
 ## Set allowed hosts to prevent host header attacks