{{Header}} __FORCETOC__
{{title|title=
Keyboard Layout
}}
{{#seo:
|description=How to change the Keyboard Layout in {{project_name_long}}.
|image=Keyboardlayout1282268640.jpg
}}
<div class="mininav">
* [[Language]]
* [[Keyboard Layout]]
</div>
[[File:Keyboardlayout1282268640.jpg|thumb]]
{{intro|
This wiki page provides information on keyboard layouts and how to configure them in {{project_name_short}}.
}}
= {{non_q_project_name_short}} =
== Desktop Environment ==

'''Table:''' ''Desktop Keyboard Layout Change''

{| class="wikitable"
|-
! scope="col"| '''Platform'''
! scope="col"| '''Steps'''
|-

! scope="row"| Xfce
|
To permanently change the keyboard layout, apply the following steps.

* <code>Applications</code> &rarr; <code>Settings</code> &rarr; <code>Keyboard</code> &rarr; <code>Layout</code> &rarr; <code>disable "use system defaults"</code> &rarr; <code>add your layout at the bottom</code> &rarr; <code>remove the old layout</code> &rarr; <code>close</code>
|-

! scope="row"| Graphical Terminal Emulator
| Temporary until reboot.

{{CodeSelect|code=
setxkbmap de
}}

Note: To set the keyboard to your preferred language, run this command to list all possible layouts. <ref>
[https://www.mankier.com/1/setxkbmap setxkbmap Man Page]
</ref>
{{CodeSelect|code=
localectl list-x11-keymap-layouts
}}
|-

! scope="row" | Wayland
| TBD. Differs depending on the Wayland compositor in use. Usually can be set using DE-specific tools, may require editing a configuration file and then restarting the compositor to make changes take effect.

<code>labwc</code> uses the <code>XKB_DEFAULT_LAYOUT</code> environment variable, as documented at https://labwc.github.io/getting-started.html
|-

|}

== Terminal ==

To change the <u>keyboard layout</u>. <ref>
French keyboards:
<br />
Perhaps an upstream bug.
<br />
( https://web.archive.org/web/20160519163403/https://free.nchc.org.tw/clonezilla-live/stable/Known-issues-Clonezilla-live.txt )
<br />
If you are using French Keymap, remember to use "Select keymap from full list":
<br />
1. Select keymap from full list
<br />
2. pc / azerty / French / Same as X11 (latin 9) /Standard
</ref>

{{CodeSelect|code=
sudo dpkg-reconfigure keyboard-configuration
}}

Make the reconfigured keyboard-configuration change take effect.

{{CodeSelect|code=
sudo setupcon
}}

<ref>
Alternative <code>/etc/default/keyboard</code> method: <br />

{{Open with root rights|filename=
/etc/default/keyboard
}}
</ref> <ref>
Alternative <code>loadkeys</code> method: <br />

Temporary until reboot.

{{CodeSelect|code=
sudo loadkeys de
}}
</ref>

= {{q_project_name_short}} =

To correctly apply changes system-wide via <code>dom0</code>: <ref>The Qubes bug reporting [https://github.com/QubesOS/qubes-issues/issues/1396 the change does not propagate to other VMs] has now been resolved.</ref>

* <code>System Tools</code> &rarr; <code>Keyboard</code> &rarr; <code>Layout</code>

Alternatively, [https://github.com/Qubes-Community/Contents/blob/master/docs/customization/language-localization.md language localization input] can be configured on a per VM basis.

If problems are encountered, see: [https://www.qubes-os.org/faq/#my-keyboard-layout-settings-are-not-behaving-correctly-what-should-i-do My keyboard layout settings are not behaving correctly. What should I do?] in the Qubes FAQ.

= See Also =
* [[Language|Change the System or Firefox Language]]

= Footnotes =
{{reflist|close=1}}

{{Footer}}

[[Category:Documentation]]