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

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
So let’s do this!

How to change your keyboard layout on Raspberry Pi?
On Raspbian, the default keyboard layout is QWERTY
You can change it in the system settings
On Desktop, go to Preferences > Raspberry Pi Configuration
And on the Lite version, you can use raspi-config to change it

After this short answer, I will now give you all the detailed steps in the following paragraphs
I’ll firstly show you how to do this on Raspbian Desktop, and then on Raspbian Lite

Change the keyboard layout on Raspbian Desktop

On Raspbian Desktop, you have a graphic tool to do this easily
It 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 Raspbian Lite

On Raspbian Lite, 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 “Change Keyboard Layout”
  • 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
Raspbian Lite will be much easier to use with the key at the right position 🙂


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

And as usual, if you have any question, feel free to leave a comment below!

This tutorial doesn't work anymore? Report the issue here, so that I can update it!

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.

2 thoughts on “How to Change your Keyboard Layout on Raspberry Pi? (Raspbian)

  1. I have RAK2245 PIHat OS which from all appearnces Raspbian 10 Buster. A couple of the keys don’t print the expected characters, specifically the backslash character ‘\’ which prints the hash character ‘#’. This is a major showstopper since postgresql command line utilizes the ‘\’ extensively. And it doesn’t print the pipe ‘|’ but a tilde ‘`’ character. This behavior has been replicated with three diffe and wirerent keyboards, Logitech wireless and wre and a wired Chromata gamer keyboard.
    Logging in via SSH the keystroked print correctly.

    Please advise.

  2. This was, by far, the most complete treatment of keyboard maps for the Raspberry Pi that I have found to date. Thank you.

    Someone, somewhere, must have figured out how to swap the command and control keys on a Raspberry Pi so that it matches an Apple keyboard layout. Using raspi-config, I have tried simply selecting every one of the “Apple” keyboard options, but none of them do what I am looking for. Simply, I would like to remap the cntrl key from it’s default location so that it is on the keys immediately adjacent to the space bar (the left of which currently calls the RPi menu), moving that functionality to the former location of the cntrl keys. To further complicate my needs, I NEED the international keyboard with dead keys functionality as well. (I switch between english and spanish multiple times a day).

    Please don’t bash me as a Mac user. I came to the mac from NextStep/OpenStep and OpenBSD. I am very happy working in Pi-world (I have deployed 6 of them in my own home for various purposes). But switching back and forth from the 2 primary OSs that I use is a pain (I have the same pain when I have to work on a windows box).

    Further, swapping these keys is user configurable option even on ChromeOS. It has simply got to be possible but I don’t know what options I would include in the /etc/default/keyboard file.

    Thanks is advance for any tips.

Leave a Reply

Your email address will not be published. Required fields are marked *

Recent Posts

Master your Raspberry Pi - 10% off