Keyboard Layout

This wiki page provides information on keyboard layouts and how to configure them in Kicksecure.
Kicksecure
[edit]Desktop Environment
[edit]Kicksecure 18 and above.
System-wide configuration.
| Platform | Steps |
|---|---|
| System-wide - TUI |
Terminal User Interface (TUI) Interactive: sudo set-system-keymap --interactive |
| System-wide - CLI |
command line interface (CLI) View available keymaps. localectl list-x11-keymap-layouts Syntax: sudo set-system-keymap keymap Example: Note: Replace sudo set-system-keymap de Manually: See below. |
| Other Wayland compositors | 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. |
Per-user configuration. (Not system-wide configuration.)
| Platform | Steps |
|---|---|
| LXQt + labwc Wayland compositor - TUI |
Terminal User Interface (TUI) Interactive: set-labwc-keymap --interactive |
| LXQt + labwc Wayland compositor - CLI |
command line interface (CLI) View available keymaps. localectl list-x11-keymap-layouts Syntax: set-labwc-keymap keymap Example: Note: Replace set-labwc-keymap de Manually: See footnote. [1] |
| Other Wayland compositors | 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. |
Multiple Keyboard Layouts
[edit]TODO: document. Meanwhile, see this forum post: https://forums.kicksecure.com/t/transfer-kicksecure-to-another-computer-cant-see-grub/1382/5![]()
Virtual Terminal
[edit]
To change the keyboard layout. [2]
Note: Changes keyboard layout for virtual terminals only. This does not effect the graphical environment. [3]
- sudo set-console-keymap
- or:
- sudo set-system-keymap
sudo set-console-keymap
Simple
[edit]set-system-keymap sets both keyboard layouts for,
- 1) command line interface (CLI), and
- 2) graphical user interface (GUI).
With 1 command only. It can either be started from
- A) System Maintenance Panel, or
- B) from the command line.
Terminal User Interface (TUI):
sudo set-system-keymap --interactive
CLI:
sudo set-system-keymap
If installing Kicksecure using its ISO, Kicksecure's Calamares based installer) uses set-system-keymap internally to configure the keyboard layout.
Kicksecure-Qubes
[edit]To correctly apply changes system-wide via dom0: [6]
System Tools→Keyboard→Layout
Alternatively, language localization input![]()
can be configured on a per VM basis.
If problems are encountered, see: My keyboard layout settings are not behaving correctly. What should I do?![]()
in the Qubes FAQ.
See Also
[edit]Footnotes
[edit]- ↑
labwcuses theXKB_DEFAULT_LAYOUTenvironment variable, as documented at https://labwc.github.io/getting-started.html
. To permanently change the keyboard layout, apply the following steps.
- Open a terminal → Run
mkdir -p ~/.config/labwc→ Runnano ~/.config/labwc/environment→ TypeXKB_DEFAULT_LAYOUT=zz, replacingzzwith the code for your keyboard layout → TypeCtrl+Sto save, thenCtrl+Xto exit → Runlabwc --reconfigureto load new settings.
- Open a terminal → Run
- ↑
French keyboards:
Perhaps an upstream bug.
( https://web.archive.org/web/20160519163403/https://free.nchc.org.tw/clonezilla-live/stable/Known-issues-Clonezilla-live.txt
)
If you are using French Keymap, remember to use "Select keymap from full list":
1. Select keymap from full list
2. pc / azerty / French / Same as X11 (latin 9) /Standard - ↑ Manually: sudo dpkg-reconfigure keyboard-configuration && sudo setupcon
- ↑
Alternative
/etc/default/keyboardmethod:
Open file/etc/default/keyboardin an editor with root rights.Select your platform.
See Open File with Root Rights for detailed instructions on why using
sudoeditimproves security and how to use it.Note: Featherpad (or the chosen text editor) must be closed before running the
sudoeditcommand.sudoedit /etc/default/keyboard
Notes:
- When using Kicksecure-Qubes, this must be done inside the Template.
sudoedit /etc/default/keyboard
- After applying this change, shut down the Template.
- All App Qubes based on the Template need to be restarted if they were already running.
- This is a general procedure required for Qubes and is unspecific to Kicksecure-Qubes.
Notes:
- This is just an example. Other tools could achieve the same goal.
- If this example does not work for you, or if you are not using Kicksecure, please refer to Open File with Root Rights.
sudoedit /etc/default/keyboard
- ↑
Alternative
loadkeysmethod:
Temporary until reboot. sudo loadkeys de - ↑
The Qubes bug reporting the change does not propagate to other VMs

has now been resolved.
We believe security software like Kicksecure needs to remain Open Source and independent. Would you help sustain and grow the project? Learn more about our 13 year success story and maybe DONATE!