systemd-vconsole-setup.service - Man Page

systemd-vconsole-setup​.service

/usr/lib/systemd/systemd-vconsole-setup [TTY]

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​.

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​.conf and on the kernel command line take precedence over these credentials​.

Note the relationship to the firstboot​.keymap credential understood by systemd-firstboot.service(1): both ultimately affect the same setting, but firstboot​.keymap is written into /etc/vconsole​.conf on first boot (if not already configured), and then read from there by systemd-vconsole-setup, while vconsole​.keymap is read on every boot, and is not persisted to disk (but any configuration in vconsole​.conf will take precedence if present)​.

Added in version 253​.

vconsole​.font,  vconsole​.font_map,  vconsole​.font_unimap,  vconsole​.font_scale

The console font settings to apply​. The matching options in vconsole​.conf and on the kernel command line take precedence over these credentials​.

vconsole​.font_scale was added in version 262​.

Added in version 253​.

If the boot loader reports the firmware-configured keyboard layout via the LoaderKeyboardLayout EFI variable (see the Boot Loader Interface​^[1]), 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​.

systemd(1), vconsole.conf(5), loadkeys(1), setfont(8), systemd-localed.service(8)

1.

Boot Loader Interface
https://systemd.io/BOOT_LOADER_INTERFACE

kernel-command-line(7), systemd.directives(7), systemd-firstboot(1), systemd.index(7), systemd.system-credentials(7), vconsole.conf(5).

The man page systemd-vconsole-setup(8) is an alias of systemd-vconsole-setup.service(8).