Skip to content

correct root of SD card to first partition #3840

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Sep 7, 2024
Merged

correct root of SD card to first partition #3840

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
c5a23da
correct root of SD card to first partition
solsticedhiver Sep 6, 2024
c1c890c
Update documentation/asciidoc/computers/configuration/headless.adoc
nathan-contino Sep 7, 2024
5fcf15b
Update documentation/asciidoc/computers/configuration/headless.adoc
nathan-contino Sep 7, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions documentation/asciidoc/computers/configuration/headless.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 `<username>:<password>`: your desired username, followed immediately by a colon, followed immediately by an *encrypted* representation of the password you want to use.

Expand Down