From c5a23da2ba3db5c1c836e0631d0dbfdd8edad0e2 Mon Sep 17 00:00:00 2001 From: solsTiCe d'Hiver Date: Sat, 7 Sep 2024 00:10:20 +0200 Subject: [PATCH 1/3] correct root of SD card to first partition Change confusing wording of location for headless config file --- documentation/asciidoc/computers/configuration/headless.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/asciidoc/computers/configuration/headless.adoc b/documentation/asciidoc/computers/configuration/headless.adoc index a404bdaf4..113b512dd 100644 --- a/documentation/asciidoc/computers/configuration/headless.adoc +++ b/documentation/asciidoc/computers/configuration/headless.adoc @@ -26,14 +26,14 @@ NOTE: Previous versions of Raspberry Pi OS made use of a `wpa_supplicant.conf` f With no keyboard or monitor, you need a way to xref:remote-access.adoc[remotely control] your headless Raspberry Pi. On first boot, the only option is SSH. To enable SSH on a fresh installation of Raspberry Pi OS, choose one of the following methods: * enable SSH in the OS customisation menu in Raspberry Pi Imager, then enter a username and password -* create a file named `ssh` at the root of the SD card, then configure a user manually with `userconf.txt` following the instructions in the section below +* create a file named `ssh` at the root of the first partition of the SD card (labeled bootfs), then configure a user manually with `userconf.txt` following the instructions in the section below For more information, see xref:remote-access.adoc#ssh[set up an SSH server]. Once you've connected over SSH, you can use `raspi-config` to xref:remote-access.adoc#vnc[enable VNC] if you'd prefer a graphical desktop environment. [[configuring-a-user]] ==== Configure a user manually -At the root of your SD card, create a file named `userconf.txt`. +At the root of the first partion of your SD card (the filesystem labeled bootfs), 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. From c1c890cc292afb5bd4e4fbbbd3dfbdc7c850507e Mon Sep 17 00:00:00 2001 From: nate contino Date: Sat, 7 Sep 2024 15:05:22 +0100 Subject: [PATCH 2/3] Update documentation/asciidoc/computers/configuration/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 113b512dd..e22c59970 100644 --- a/documentation/asciidoc/computers/configuration/headless.adoc +++ b/documentation/asciidoc/computers/configuration/headless.adoc @@ -26,7 +26,7 @@ NOTE: Previous versions of Raspberry Pi OS made use of a `wpa_supplicant.conf` f With no keyboard or monitor, you need a way to xref:remote-access.adoc[remotely control] your headless Raspberry Pi. On first boot, the only option is SSH. To enable SSH on a fresh installation of Raspberry Pi OS, choose one of the following methods: * enable SSH in the OS customisation menu in Raspberry Pi Imager, then enter a username and password -* create a file named `ssh` at the root of the first partition of the SD card (labeled bootfs), then configure a user manually with `userconf.txt` following the instructions in the section below +* create a file named `ssh` at the root of the first partition of the SD card (labeled `bootfs`), then configure a user manually with `userconf.txt` following the instructions in the section below For more information, see xref:remote-access.adoc#ssh[set up an SSH server]. Once you've connected over SSH, you can use `raspi-config` to xref:remote-access.adoc#vnc[enable VNC] if you'd prefer a graphical desktop environment. From 5fcf15bbe2450a4cf45a1150a5eacb09783bd649 Mon Sep 17 00:00:00 2001 From: nate contino Date: Sat, 7 Sep 2024 15:05:27 +0100 Subject: [PATCH 3/3] Update documentation/asciidoc/computers/configuration/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 e22c59970..fb4ea3e64 100644 --- a/documentation/asciidoc/computers/configuration/headless.adoc +++ b/documentation/asciidoc/computers/configuration/headless.adoc @@ -33,7 +33,7 @@ For more information, see xref:remote-access.adoc#ssh[set up an SSH server]. Onc [[configuring-a-user]] ==== Configure a user manually -At the root of the first partion of your SD card (the filesystem labeled bootfs), create a file named `userconf.txt`. +At the root of the first partion of your SD card (the filesystem labeled `bootfs`), 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.