Name
systemd-vconsole-setup.service, systemd-vconsole-setup — Configure the virtual consoles
Synopsis
systemd-vconsole-setup.service
/usr/lib/systemd/systemd-vconsole-setup [TTY]
Description¶
systemd-vconsole-setup sets up and configures either all virtual consoles, or
— if the optional TTY parameter is provided — a specific one. When the system
is booting up, systemd-vconsole-setup.service is called by
systemd-udevd(8) during
VT console subsystem initialization. Also,
systemd-localed.service(8)
invokes it as needed when language or console changes are made.
Internally, this program calls
loadkeys(1)
and
setfont(8).
Execute systemctl restart systemd-vconsole-setup.service in order to apply any manual
changes made to /etc/vconsole.conf.
See vconsole.conf(5) for information about the configuration files and kernel command line options understood by this program.
Credentials¶
systemd-vconsole-setup supports the service credentials logic as implemented by
ImportCredential=/LoadCredential=/SetCredential=
(see systemd.exec(5) for
details). The following credentials are used when passed in:
vconsole.keymap,vconsole.keymap_toggle¶The keymap (and toggle keymap) to apply. The matching options in
vconsole.confand on the kernel command line take precedence over these credentials.Note the relationship to the
firstboot.keymapcredential understood by systemd-firstboot.service(1): both ultimately affect the same setting, butfirstboot.keymapis written into/etc/vconsole.confon first boot (if not already configured), and then read from there by systemd-vconsole-setup, whilevconsole.keymapis read on every boot, and is not persisted to disk (but any configuration invconsole.confwill take precedence if present).vconsole.font,vconsole.font_map,vconsole.font_unimap,vconsole.font_scale¶The console font settings to apply. The matching options in
vconsole.confand on the kernel command line take precedence over these credentials.vconsole.font_scalewas added in version 262.
Firmware-provided keyboard layout¶
If the boot loader reports the firmware-configured keyboard layout via the
LoaderKeyboardLayout EFI variable (see the
Boot Loader Interface),
systemd-vconsole-setup uses it as the lowest-priority fallback for the
keymap. The RFC 4646 / BCP 47 language tag reported by the firmware (e.g. "de-DE") is
matched against the optional sixth column of /usr/share/systemd/kbd-model-map,
which lists the language tags each virtual-console keymap covers. Credentials,
/etc/vconsole.conf, and kernel command line options all override this
firmware-provided default.