Change Keyboard Layout

Displaying the Current Settings

As mentioned before, you can check your current keyboard layout configuration with the following command:

In the following output, you can see the keyboard layout configured for the virtual console and for the X11 window system.

Listing Available Keymaps

To list all available keyboard layouts that can be configured on your system, type:

You can use grep to search the output of the previous command for a specific keymap name. There are often multiple keymaps compatible with your currently set locale. For example, to find available Czech keyboard layouts, type:

Setting the Keymap

To set the default keyboard layout for your system, use the following command as root:

Replace map with the name of the keymap taken from the output of the localectl list-keymaps command. Unless the --no-convert option is passed, the selected setting is also applied to the default keyboard mapping of the X11 window system, after converting it to the closest matching X11 keyboard mapping. This also applies in reverse, you can specify both keymaps with the following command as root:

If you want your X11 layout to differ from the console layout, use the --no-convert option.

With this option, the X11 keymap is specified without changing the previous console layout setting.

Imagine you want to use German keyboard layout in the graphical interface, but for console operations you want to retain the US keymap. To do so, type as root:

Then you can verify if your setting was successful by checking the current status:

Apart from keyboard layout (map), three other options can be specified:

Replace model with the keyboard model name, variant and options with keyboard variant and option components, which can be used to enhance the keyboard behavior. These options are not set by default. For more information on X11 Model, X11 Variant, and X11 Options see the kbd(4) man page.