Raspberry Pi OS removes default “Pi” username, adds experimental support for Wayland

The Raspberry Pi Foundation has just released a new version of Raspberry Pi OS that removes the default username (pi) for security reasons, adds experimental support for Wayland, and lets people configure their Raspberry Pi with Bluetooth keyboard and mouse.

Default username no more

The most significant change in the new Raspberry Pi OS is the removal of the default “pi” user as several countries have legislation against default credentials for security reasons. That includes the Product Security and Telecommunications Infrastructure Bill (PSTI) in the UK, and California’s SB-327 IoT devices security law. Those laws mostly target default passwords, but removing a default username can be useful too to prevent force brute attacks.

One consequence of removing the default username is that you won’t be able to skip the wizard in both the Desktop and Lite versions of Raspberry Pi OS since a new user needs to be created first.

Raspberry Pi OS create user
Creating a new user in Raspberry Pi OS
Raspberry Pi OS Lite create user
Creating a new user in Raspberry Pi OS Lite

People having a headless setup will now need to create a new user either in the Raspberry Pi imager program before flashing the image…

Raspberry Pi Imager username password

.. or create a file called userconf or userconf.txt in the boot partition of the SD card with the string “<username>:<encrypted-password> with your username and an encrypted password that can be generated by the following command in an already running Raspberry Pi SBC or other Linux computer/board:

Finally, the Raspberry Pi Foundation also provides a mechanism for existing installations to rename “pi” username to another username:

While you could always keep on using “pi” as your username, you’ll get a warning doing so. That may still be required for programs where /home/pi folder or “pi” username are hardcoded into the source code, but hopefully, those will soon be updated. Many Raspberry Pi tutorials will rely on “pi” username and “/home/pi” folder, and it may confuse some beginners.

Configuring Raspberry Pi OS with Bluetooth keyboard/mouse

There was also another small change in the wizard: support for Bluetooth HID devices. Previously, you always needed to use a USB mouse and/or keyboard to initially pair the Bluetooth peripherals, but the new wizard will prompt you to put any Bluetooth keyboard or mouse you wish to use into pairing mode, then scan for Bluetooth mice and keyboards, and will automatically pair them. This works both on Raspberry Pi 3 and 4 with built-in Bluetooth, and older Raspberry Pi through a compatible USB Bluetooth adapter.

Experimental Wayland support

Raspberry Pi OS BullsEye runs mutter window manager by default instead of openbox, and currently relies on the X Windows System, but also supports Wayland.  The latter was not available at all on Raspberry Pi OS until the new release, and it is now possible to run Raspberry Pi OS desktop on top of Wayland. Since it’s experimental, it is not recommended for typical users, and features such as taking screenshots, the screen magnifier, and any remote desktop applications will not work at all at this time.

The Raspberry Pi Foundation also says that it is not a pure Wayland implementation of the desktop so Wayland and X are running side-by-side, with X being used for communication between applications. That means the mutter window manager runs as a true Wayland application, but everything else runs under XWayland, an implementation of X which uses Wayland to draw the graphics.

If you’d like to switch to Wayland, you can do so with raspi-config, go to the Advanced Options option and select Wayland.

You’ll probably not notice any changes, bt you can check whether Wayland is running in the terminal:

Under X, this will return “x11”; under Wayland it will return “wayland”.

Upgrading Raspberry Pi OS (April 4, 2022)

To upgrade your existing system to the latest version, simply run:

Wayland support will not be installed by default, and it will not be needed by most users, but you can install it as follows:

Via Raspberry Pi Blog.

Share this:

Support CNX Software! Donate via PayPal or cryptocurrencies, become a Patron on Patreon, or buy review samples

ROCK Pi 4C Plus
Notify of
The comment form collects your name, email and content to allow us keep track of the comments placed on the website. Please read and accept our website Terms and Privacy Policy to post a comment.
1 month ago

Wayland has been around for such a long time. I’ve tried to switch to wayland a few times on my laptop. It always ends in trouble and or problems which are solved by going back to x11.

Is it just me that is having such a bad time with wayland?

Hope the Pi experience with it is better =P

1 month ago

any benchmarks ? glmark2-wayland vs glmark2-x ?

1 month ago

Wayland will always be the monitor refresh rate. It only presents complete frames.

1 month ago

Seeing on YT the stable is for Pi are Twister (funny&fresh) Ubuntu mate and Pop!

Lighter and fast is Pop! So why not Pi developers can’t reach a collaboration w/ Pop! OS team? Maybe can birth a really nice OS.

1 month ago

If OS looks nice or not is pretty much individual preference, so this can never have a common ground. Some like kitsch, some minimalism.

Lightest and fastest in this segment (out of mentioned) is Armbian but it doesn’t look funny or fancy. Its just brutally effective. Can be close to Debian, can smell on Ubuntu. Its mega potential is a build system which can deliver a whole Debian based distribution. Tailored for HW or for look – add one config and you have PopOS look, add another config and you have tons of additional stuff … https://github.com/armbian/build

1 month ago

I just upgraded my zero and rename-user does not exist