Skip to content

Hint to new userconfig file for ssh servers in headless setups. #2630

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 6 commits into from
Oct 6, 2022
Merged

Hint to new userconfig file for ssh servers in headless setups. #2630

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
a9ae9b6
Hint to new userconfig file for ssh servers in headless setups.
gituser789 Sep 29, 2022
fca00b4
rm specific date in documentation due to irrelevant information
gituser789 Sep 29, 2022
44a8bb3
fix internal linking
gituser789 Sep 29, 2022
79a285d
restore overwriting link to raspberry-config
gituser789 Oct 6, 2022
2ec92ac
fix internal linking again
gituser789 Oct 6, 2022
361e49a
Update secure-shell.adoc
aallan Oct 6, 2022
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
1 change: 1 addition & 0 deletions documentation/asciidoc/computers/configuration/headless.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,7 @@ NOTE: Some older Raspberry Pi boards and some USB wireless dongles do not suppor

NOTE: With no keyboard or monitor, you will need some way of xref:remote-access.adoc[remotely accessing] your headless Raspberry Pi. For headless setup, SSH can be enabled by placing a file named `ssh`, without any extension, onto the boot folder of the SD Card. For more information see the section on xref:remote-access.adoc#ssh[setting up an SSH server].

[[configuring-a-user]]
=== Configuring a User

You will need to add a `userconf.txt` in the boot partition of the SD card; this is the part of the SD card which can be seen when it is mounted in a Windows or MacOS computer.
Expand Down
2 changes: 2 additions & 0 deletions documentation/asciidoc/computers/remote-access/secure-shell.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,4 +31,6 @@ Alternatively you can enable it from the terminal using the xref:configuration.a

NOTE: For headless setup, SSH can be enabled by placing a file named `ssh`, without any extension, onto the boot partition of the SD Card. When the Raspberry Pi boots, it looks for the `ssh` file. If it is found, SSH is enabled and the file is deleted. The content of the file does not matter; it could contain text, or nothing at all.

NOTE: For headless setup in addition to the `ssh`-file you need a `userconfig`-file, which contains a string `username:encryptedpassword`. Please refer to the section on xref:configuration.adoc#configuring-a-user[configuring a user] in the discussions around headless setup of a Raspberry Pi.

WARNING: When enabling SSH on a Raspberry Pi that may be connected to the internet, you should ensure that your password is not easily brute forced.