How to Change your Keyboard Layout on Raspberry Pi? (RPI OS)

If, like me, you don’t use a QWERTY keyboard, the first thing you are probably looking for on your Raspberry Pi is how to change the default layout. In this article, I will explain how to do this on Raspberry Pi OS.

On Raspberry Pi OS, the default keyboard layout is QWERTY. It can either be changed in the Raspberry Pi Configuration tool from a Desktop environment, or via raspi-config in a terminal or Lite version.

If you are new to this, I will now give you all the detailed steps in the following paragraphs.
I’ll firstly show you how to do this on Raspberry Pi OS Desktop, and then on Raspberry Pi OS Lite.

If you need help getting started on Raspberry Pi, I have an entire course to guide you through your first steps. I’ll help you use the perfect hardware, plug everything in and install your first system. You’ll also do your first project with me, just to make sure you are ready for the next level. Get all the information on this page if you are interested.

Change the keyboard layout on Raspberry Pi OS Desktop

On Raspberry Pi OS with Desktop, the keyboard layout can be changed by going into Preferences > Raspberry Pi Configuration, and then finding the keyboard settings under the localisation tab.

Download the Pi Glossary!
If you are lost in all these new words and abbreviations, request my free Raspberry Pi glossary here (PDF format)!

You have a graphic tool to do this easily, so this will be a short tutorial :).

  • Open the main menu.
  • Go to Preferences > Raspberry Pi Configuration.
  • Then go to the “Localisation” tab.
  • And finally, click on “Set Keyboard”.
  • From here you can select:
    • The keyboard model: Most of the time you can keep the default one.
    • The layout: Basically it’s the keyboard country you are using.
    • The variant: If you keyboard use a specific layout for this country, select it here (DVORAK for example).
  • Click “OK” to apply the changes.

That’s it, your Raspberry Pi is now using your favorite keyboard layout.

Change the keyboard layout on Raspberry Pi OS Lite

On Raspberry Pi OS Lite, the easiest way to change the keyboard layout is to use raspi-config. The keyboard settings are in the “Localisation Options” menu.

There is no graphic tool, but raspi-config will help you to do this :).

  • Start raspi-config.
    sudo raspi-config
    If you’re having trouble entering this command, here’s what the default keyboard layout looks like:

    Click on the keys on your keyboard corresponding to this layout.
  • Go to “Localisation Options”.
  • Then select “Keyboard”.
  • The first step is to pick the keyboard model you are using.

    Most of the time, you can keep the default one.
  • Now, you need to select the keyboard layout.
    English layouts are available in the first window:

    If you need to use a layout for another country, click on “Other”.
  • Here you can pick the country corresponding to your keyboard.
  • And finally, choose the specific layout for this country.
    If you don’t know, select the first one in the list.
  • The last two or three questions are for the keyboard configuration.
    The first one for the “Alt Gr” key:

    I always keep the default configuration personally.
  • The next one for the compose key.

    Same thing, only configure it if you need to use it.
  • And finally the CTRL+ALT+BACKSPACE combination that you can configure too

That’s it, after a few seconds your keyboard is now correctly configured.
Raspberry Pi OS Lite will be much easier to use with the key at the right position :).

Download the Pi Glossary!
If you are lost in all these new words and abbreviations, request my free Raspberry Pi glossary here (PDF format)!

You can use the same thing via SSH by the way, with the advantage that the keyboard layout via SSH will be the one you use on your computer.

Are you a bit lost in the Linux command line? Check this article first, for the most important commands to remember, and a free downloadable cheat sheet so you can have the commands at your fingertips.


How to change the keyboard layout on a Debian-based distribution?

On any Debian-based system, the keyboard layout is stored in the /etc/default/keyboard file. It’s possible to edit this file to change the current keyboard layout, even when raspi-config is not available.

More details on the Debian wiki.

How to change the keyboard layout on RetroPie?

Retropie is based on Raspberry Pi OS, raspi-config is available in command line or via the settings menu. Open it and go to Localisation options > Keyboard to select the layout you want to use.

Check my complete guide about Retropie for beginners here.

Get My Commands Cheat Sheet!
Grab your free PDF file with all the commands you need to know on Raspberry Pi!

Reminder: Remember that all the members of my community get access to this website without ads, exclusive courses and much more. You can become part of this community for as little as $5 per month & get all the benefits immediately.


Congrats! You now know how to change the default keyboard configuration on your Raspberry Pi.
It’s often the first step after the installation, and even if this tutorial is relatively short, it is crucial to take a good start on Raspberry Pi.

If you are just starting, you can also check my list of beginner tips on Raspberry Pi

Get My Commands Cheat Sheet!
Grab your free PDF file with all the commands you need to know on Raspberry Pi!

Additional Resources

Not sure where to start?
Understand everything about the Raspberry Pi, stop searching for help all the time, and finally enjoy completing your projects.
Watch the Raspberry Pi Bootcamp course now.

Master your Raspberry Pi in 30 days
Don’t want the basic stuff only? If you are looking for the best tips to become an expert on Raspberry Pi, this book is for you. Learn useful Linux skills and practice multiple projects with step-by-step guides.
Download the e-book.

VIP Community
If you just want to hang out with me and other Raspberry Pi fans, you can also join the community. I share exclusive tutorials and behind-the-scenes content there. Premium members can also visit the website without ads.
More details here.

Need help building something with Python?
Create, understand and improve any Python script for your Raspberry Pi.
Learn the essentials, step-by-step, without losing time understanding useless concepts.
Get the e-book now.

You can also find all my recommendations for tools and hardware on this page.

Patrick Fromaget

I'm the lead author and owner of My goal is to help you with your Raspberry Pi problems using detailed guides and tutorials. In real life, I'm a Linux system administrator with a web developer experience.

Recent Posts