From fcf329e172e6ef8d8becce8d486402346f2283bd Mon Sep 17 00:00:00 2001 From: Dan Bungert Date: Fri, 10 Mar 2023 07:43:33 -0700 Subject: [PATCH] docs: update expectations for password --- documentation/autoinstall-reference.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/documentation/autoinstall-reference.md b/documentation/autoinstall-reference.md index 0d248fd0..ea2b4076 100644 --- a/documentation/autoinstall-reference.md +++ b/documentation/autoinstall-reference.md @@ -413,6 +413,20 @@ The hostname for the system. The password for the new user, crypted. This is required for use with sudo, even if SSH access is configured. +The crypted password string must conform to what [passwd](https://manpages.ubuntu.com/manpages/jammy/en/man1/passwd.1.html) expects. Depending on the special characters in the password hash, quoting may be required, so it's safest to just always include the quotes around the hash. + +Several tools can generate the crypted password, such as `mkpasswd` from the `whois` package, or `openssl passwd`. + +Example: + +```yaml +identity: + realname: 'Ubuntu User' + username: ubuntu + password: '$6$wdAcoXrU039hKYPd$508Qvbe7ObUnxoj15DRCkzC3qO7edjH0VV7BPNRDYK4QR8ofJaEEF2heacn0QgD.f8pO8SNp83XNdWG6tocBM1' + hostname: ubuntu +``` + ### active-directory **type:** mapping, see below