Raspberry Pi default username/password no longer automatically work with the a fresh install of the latest OS. Heres how to set up your Pi with the latest OS

Published: April 11, 2022

The Raspberry Pi foundation recently launched an update to the Raspberry Pi OS which changes how you need to setup your Pi for the first time. Until now, the Raspberry Pi OS has had a default user called "pi", which is no longer the case for fresh OS installs. Having a default username and password has caused some worry about potential brute-force attacks and some countries are introducing legislation to forbid any Internet-connected device from having default login credentials.

Table of Contents

The New Setup

Many people familiar with Raspberry Pis are also familiar with the setup wizard, which runs when you turn on your Pi for the first time. It helps you to configure localization settings, connect to Wi-Fi and install latest software updates. However, using the setup wizard has always been optional since it used to be possible to just press "Cancel" on the first page.


From now on the wizard is no longer optional. This is because the default user "pi" no longer exists and a user must be created before the OS can be used. Once you've gone through the new setup wizard, everything will work just like before.

Using Raspberry Pi OS Lite

If you're using the Raspberry Pi OS Lite which doesn't come with a desktop environment. You will not see the setup wizard but you will still need to create a new user account. Thankfully, this is just as easy. During the setup process, you will be prompted to create a new account. The only difference is that the creation wizard looks more crude.


Headless Setup

If you prefer to setup your Raspberry Pi headlessly, i.e without using a monitor, the above instructions won't work. You have two options to create a user headlessly: 1) Using the Raspberry Pi Imager 2) Adding a userconf.txt file to the boot partition of your SD card

Using the Official Imager

If you're using the official Raspberry Pi Imager, update to its latest version. After selecting a source image and your SD card, you can click on a new "Settings" button which has a familiar gear icon on it. This allows you to preconfigure a user to the OS image you're about to write onto your SD card. Once you've done this, the headless setup process works just like before.


Using Third Party Imagers

If you prefer to use a third party imager, like Balena Etcher, you will have to create a user by adding a configuration file to the boot partition of your SD card.

After writing the image to your SD card, open the SD card with your favourite file explorer and create a file called userconf.txt. This file should only have one line of text consisting of the username you want, followed by a colon, followed by your password in an encrypted form: username:encrypted-password

The easiest way to encrypt your password is to use OpenSSL which comes with any Raspberry Pi. You can also install it on any Windows, MacOS or Linux computer.

echo 'somepassword' | openssl passwd -6 -stdin

This will give you a string of what seems like random characters but it's actually an encrypted version of your password:


Copy this string of text to the file you created like so:


After this, all you need to do is to put your SD card into your Pi and you'll be up and running.

Updating to the Latest Version of Raspberry Pi OS

For new installs using the official Imager, the app will automatically get the latest version and write it to your SD card.

For third party imagers, you can download the latest version from Raspberry Pi foundation's download page

If you want to update an existing image, run the following commands:

sudo apt update
sudo apt full-upgrade

That's it. I hope I saved you from some headache with setting up your Pi after most of the online tutorials have become outdated.

Share on social media: