vconsole.conf
systemd
Developer
Lennart
Poettering
lennart@poettering.net
vconsole.conf
5
vconsole.conf
configuration file for the virtual console
/etc/vconsole.conf
Description
The /etc/vconsole.conf file
configures the virtual console, i.e. keyboard mapping
and console font. It is applied at boot by
systemd-vconsole-setup.service8.
The basic file format of the
vconsole.conf is a
newline-separated list environment-like
shell-compatible variable assignments. It is possible
to source the configuration from shell scripts,
however, beyond mere variable assignments no shell
features are supported, allowing applications to read
the file without implementing a shell compatible
execution engine.
Note that the kernel command line options
vconsole.keymap=,
vconsole.keymap.toggle=,
vconsole.font=,
vconsole.font.map=,
vconsole.font.unimap= may be used
to override the console settings at boot.
Depending on the operating system other
configuration files might be checked for configuration
of the virtual console as well, however only as
fallback.
Options
The following options are understood:
KEYMAP=
KEYMAP_TOGGLE=
Configures the key
mapping table for the
keyboard. KEYMAP=
defaults to us if
not set. The
KEYMAP_TOGGLE= can
be used to configured a second toggle
keymap and is by default
unset.
FONT=
FONT_MAP=
FONT_UNIMAP=
Configures the console
font, the console map and the unicode
font map. FONT=
defaults to
latarcyrheb-sun16.
Example
German keyboard and console
/etc/vconsole.conf:
KEYMAP=de-latin1
FONT=latarcyrheb-sun16
See Also
systemd1,
systemd-vconsole-setup.service8,
loadkeys1,
setfont8,
locale.conf5,
systemd-localed.service8