− Control the system locale and keyboard layout
may be used to query and change the system locale and
keyboard layout settings.
locale controls the language settings of system services and
of the UI before the user logs in, such as the display
manager, as well as the default for users after login.
settings control the keyboard layout used on the text
console and of the graphical UI before the user logs in,
such as the display manager, as well as the default for
users after login.
systemd-firstboot(1) to initialize the system locale
for mounted (but not booted) system images.
options are understood:
Do not query the user for
authentication for privileged operations.
If set−keymap or
set−x11−keymap is invoked and this option
is passed, then the keymap will not be converted from the
console to X11, or X11 to console, respectively.
Execute the operation remotely.
Specify a hostname, or a username and hostname separated by
"@", to connect to. The hostname may optionally be
suffixed by a container name, separated by ":",
which connects directly to a specific container on the
specified host. This will use SSH to talk to the remote
machine manager instance. Container names may be enumerated
with machinectl −H HOST.
Print a short help text and
Print a short version string
Do not pipe output into a
commands are understood:
Show current settings of the
system locale and keyboard mapping.
Set the system locale. This
takes one or more assignments such as
"LC_MESSAGES=en_GB.utf8", and so on. See
locale(7) for details on the available settings and
their meanings. Use list−locales for a list of
available locales (see below).
List available locales useful
for configuration with set−locale.
Set the system keyboard mapping
for the console and X11. This takes a mapping name (such as
"de" or "us"), and possibly a second one
to define a toggle keyboard mapping. Unless
−−no−convert is passed, the
selected setting is also applied as the default system
keyboard mapping of X11, after converting it to the closest
matching X11 keyboard mapping. Use list−keymaps
for a list of available keyboard mappings (see below).
List available keyboard
mappings for the console, useful for configuration with
LAYOUT [MODEL [VARIANT [OPTIONS]]]
Set the system default keyboard
mapping for X11 and the virtual console. This takes a
keyboard mapping name (such as "de" or
"us"), and possibly a model, variant, and options,
see kbd(4) for details. Unless
−−no−convert is passed, the
selected setting is also applied as the system console
keyboard mapping, after converting it to the closest
matching console keyboard mapping.
List available X11 keymap
models, layouts, variants and options, useful for
configuration with set−keymap. The command
takes a layout parameter to limit the output to the variants
suitable for the specific layout.
On success, 0
is returned, a non−zero failure code otherwise.
Pager to use when
−−no−pager is not given; overrides
$PAGER. Setting this to an empty string or the value
"cat" is equivalent to passing
Override the default options
passed to less ("FRSXMK").
vconsole.conf(5), loadkeys(1), kbd(4),
The XKB Configuration