From cba291f419dbac809642517fdb93f96fd5d2d8e8 Mon Sep 17 00:00:00 2001 From: Hermann Leinweber Date: Thu, 11 Jan 2024 13:22:50 +0100 Subject: [PATCH 1/4] Update headless.adoc: Add details about allowed symbols for the username --- documentation/asciidoc/computers/configuration/headless.adoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/documentation/asciidoc/computers/configuration/headless.adoc b/documentation/asciidoc/computers/configuration/headless.adoc index d7d065ddb..08fd167fc 100644 --- a/documentation/asciidoc/computers/configuration/headless.adoc +++ b/documentation/asciidoc/computers/configuration/headless.adoc @@ -37,6 +37,8 @@ At the root of your SD card, create a file named `userconf.txt`. This file should contain a single line of text, consisting of `:`: your desired username, followed immediately by a colon, followed immediately by an *encrypted* representation of the password you want to use. +NOTE: `` must only contain lower-case letters, digits and hyphens, and must start with a letter. (More details `/etc/adduser.conf`: `NAME_REGEX="^[a-z][-a-z0-9_]*\$?$"`) + To generate the encrypted password, use https://www.openssl.org[OpenSSL] on another computer. Open a terminal and enter the following: ---- From 2a96b964c52e18240c0b3868e2b4680973adc4fa Mon Sep 17 00:00:00 2001 From: Hermann Leinweber Date: Fri, 12 Jan 2024 15:31:42 +0100 Subject: [PATCH 2/4] Update headless.adoc: Add note about recommended max username length. --- documentation/asciidoc/computers/configuration/headless.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/computers/configuration/headless.adoc b/documentation/asciidoc/computers/configuration/headless.adoc index 08fd167fc..59b15d0ac 100644 --- a/documentation/asciidoc/computers/configuration/headless.adoc +++ b/documentation/asciidoc/computers/configuration/headless.adoc @@ -37,7 +37,7 @@ At the root of your SD card, create a file named `userconf.txt`. This file should contain a single line of text, consisting of `:`: your desired username, followed immediately by a colon, followed immediately by an *encrypted* representation of the password you want to use. -NOTE: `` must only contain lower-case letters, digits and hyphens, and must start with a letter. (More details `/etc/adduser.conf`: `NAME_REGEX="^[a-z][-a-z0-9_]*\$?$"`) +NOTE: `` must only contain lower-case letters, digits and hyphens, and must start with a letter. It should not be longer than 30 characters to avoid unexpected side effects. (See this https://systemd.io/USER_NAMES/[article] for more details.) To generate the encrypted password, use https://www.openssl.org[OpenSSL] on another computer. Open a terminal and enter the following: From 1679471cc653bb2e0e918f6efef5a09d591500db Mon Sep 17 00:00:00 2001 From: Hermann Leinweber Date: Mon, 15 Jan 2024 17:48:22 +0100 Subject: [PATCH 3/4] headless.adoc: Update max username length to 32 --- documentation/asciidoc/computers/configuration/headless.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/computers/configuration/headless.adoc b/documentation/asciidoc/computers/configuration/headless.adoc index 59b15d0ac..327b912dd 100644 --- a/documentation/asciidoc/computers/configuration/headless.adoc +++ b/documentation/asciidoc/computers/configuration/headless.adoc @@ -37,7 +37,7 @@ At the root of your SD card, create a file named `userconf.txt`. This file should contain a single line of text, consisting of `:`: your desired username, followed immediately by a colon, followed immediately by an *encrypted* representation of the password you want to use. -NOTE: `` must only contain lower-case letters, digits and hyphens, and must start with a letter. It should not be longer than 30 characters to avoid unexpected side effects. (See this https://systemd.io/USER_NAMES/[article] for more details.) +NOTE: `` must only contain lower-case letters, digits and hyphens, and must start with a letter. It must not be longer than 32 characters. (See this https://systemd.io/USER_NAMES/[article] for more details.) To generate the encrypted password, use https://www.openssl.org[OpenSSL] on another computer. Open a terminal and enter the following: From 11df7d73aef275320101f064eee55f6d47df3eb0 Mon Sep 17 00:00:00 2001 From: Alasdair Allan Date: Mon, 15 Jan 2024 16:49:57 +0000 Subject: [PATCH 4/4] Update headless.adoc --- documentation/asciidoc/computers/configuration/headless.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/asciidoc/computers/configuration/headless.adoc b/documentation/asciidoc/computers/configuration/headless.adoc index 327b912dd..30b8709e2 100644 --- a/documentation/asciidoc/computers/configuration/headless.adoc +++ b/documentation/asciidoc/computers/configuration/headless.adoc @@ -37,7 +37,7 @@ At the root of your SD card, create a file named `userconf.txt`. This file should contain a single line of text, consisting of `:`: your desired username, followed immediately by a colon, followed immediately by an *encrypted* representation of the password you want to use. -NOTE: `` must only contain lower-case letters, digits and hyphens, and must start with a letter. It must not be longer than 32 characters. (See this https://systemd.io/USER_NAMES/[article] for more details.) +NOTE: `` must only contain lower-case letters, digits and hyphens, and must start with a letter. It must not be longer than 32 characters. To generate the encrypted password, use https://www.openssl.org[OpenSSL] on another computer. Open a terminal and enter the following: