Skip to content

Commit 7f94e9a

Browse files
committed
Add instructions to disable admin password
Since RPi OS version 6.2, the admin password is required by default for all sudo commands. The added instructions explain how to disable it for the software to function correctly.
1 parent 1c430ff commit 7f94e9a

File tree

1 file changed

+22
-2
lines changed

1 file changed

+22
-2
lines changed

docs/software/pisetup.md

Lines changed: 22 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,9 @@ Select your SD card as storage medium and continue to the **Customisation** sett
1818
you will need it to connect to the RPi via SSH later.
1919
- Check if the **Localisation** settings are already correct and modify them if needed.
2020
- Continue to **User** and keep the default `pi` as username. Changing the username will
21-
break the software functionality, do this on your own risk. Choose a simple password, you
22-
won't actually need it, as we will set up SSH key based authentication in the next steps.
21+
break the software functionality, do this on your own risk. Choose a password and note
22+
it. By default, you will need it when running `sudo` commands since RPi OS version 6.2.
23+
Make sure to change this default setting in the [Update RPi](#update-rpi) step.
2324

2425
![Raspberry Pi Imager Choose Username](assets/images/raspberrypi_imager_choose_username.png){ width="700" }
2526

@@ -175,6 +176,25 @@ folder in VS Code. This makes working with files on the Raspberry Pi easier
175176

176177
## Update RPi
177178

179+
!!! warning "Disable admin password"
180+
181+
If you set up your SD card after April 14 (2026), you will have the latest
182+
RPi OS 6.2 installed, where passwordless sudo is now disabled by default
183+
([blog post](https://www.raspberrypi.com/news/a-security-update-for-raspberry-pi-os/){target=_blank}).
184+
For the insect-detect software to function correctly, we will need to enable
185+
passwordless sudo again by disabling the admin password in the system settings.
186+
187+
Open the [`raspi-config`](https://www.raspberrypi.com/documentation/computers/configuration.html#raspi-config){target=_blank}
188+
tool by running:
189+
190+
``` bash
191+
sudo raspi-config
192+
```
193+
194+
Go to `1 System Options` and then `S10 Admin Password`. When asked if you would
195+
like the admin (sudo) password to be enabled, choose `No`, which will disable the
196+
admin password. Hit `Finish` to close the `raspi-config` tool.
197+
178198
We will start with updating the already installed software by running:
179199

180200
``` bash

0 commit comments

Comments
 (0)