From b6db5e7c610b47ff9100c89f725cf917c60eb34c Mon Sep 17 00:00:00 2001 From: Catherine Luse Date: Mon, 30 Aug 2021 18:57:13 -0700 Subject: [PATCH] Document bootstrap password --- .../resources/bootstrap-password/_index.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 content/rancher/v2.6/en/installation/resources/bootstrap-password/_index.md diff --git a/content/rancher/v2.6/en/installation/resources/bootstrap-password/_index.md b/content/rancher/v2.6/en/installation/resources/bootstrap-password/_index.md new file mode 100644 index 00000000000..4cd48755b10 --- /dev/null +++ b/content/rancher/v2.6/en/installation/resources/bootstrap-password/_index.md @@ -0,0 +1,17 @@ +--- +title: Bootstrap Password +weight: 800 +--- + +When Rancher starts for the first time, a password is randomly generated for the first admin user. When the admin first logs in to Rancher, the UI shows commands that can be used to retrieve the bootstrap password. The admin needs to run those commands and log in with the bootstrap password. Then Rancher gives the admin an opportunity to reset the password. + +The bootstrap password is randomly generated if it is not set during installation with a variable. For details on how to set the bootstrap password using a variable, see below. + +### Specifying the Bootstrap Password in Helm Installs + +For a Helm install, users can specify the bootstrap password variable by configuring it in the Helm chart values with `.Values.bootstrapPassword`. The password will be stored in a Kubernetes secret and the UI will show instructions for how to retrieve password on `note.txt` after Rancher is installed. + + +### Specifying the Bootstrap Password in Docker Installs + +For a Docker install, you can specify the bootstrap password by passing `-e CATTLE_BOOTSTRAP_PASSWORD=password` to the Docker install command. \ No newline at end of file