SYSTEMD-VCONSOLE-SETUP.SERVICE(8) systemd-vconsole-setup.service SYSTEMD-VCONSOLE-SETUP.SERVICE(8)

.SH "NAME" systemd-vconsole-setup.service, systemd-vconsole-setup - Configure the virtual consoles

.SH "SYNOPSIS"

.PP systemd-vconsole-setup.service

.HP 960u

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

.SH "DESCRIPTION"

.PP **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)](/man/os/systemd/systemd-udevd.8) during VT console subsystem initialization. Also, [**systemd-localed.service**(8)](/man/os/systemd/systemd-localed.service.8) invokes it as needed when language or console changes are made. Internally, this program calls [**loadkeys**(1)](/man/os/systemd/loadkeys.1) and [**setfont**(8)](/man/os/systemd/setfont.8).

.PP Execute **systemctl restart systemd-vconsole-setup.service** in order to apply any manual changes made to /etc/vconsole.conf.

.PP See [**vconsole.conf**(5)](/man/os/systemd/vconsole.conf.5) for information about the configuration files and kernel command line options understood by this program.

.SH "CREDENTIALS"

.PP **systemd-vconsole-setup** supports the service credentials logic as implemented by *ImportCredential=*/*LoadCredential=*/*SetCredential=* (see [**systemd.exec**(5)](/man/os/systemd/systemd.exec.5) for details). The following credentials are used when passed in:

.PP *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)](/man/os/systemd/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.

.RE

.PP *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.

.RE

.SH "FIRMWARE-PROVIDED KEYBOARD LAYOUT"

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

.SH "SEE ALSO"

.PP [**systemd**(1)](/man/os/systemd/systemd.1), [**vconsole.conf**(5)](/man/os/systemd/vconsole.conf.5), [**loadkeys**(1)](/man/os/systemd/loadkeys.1), [**setfont**(8)](/man/os/systemd/setfont.8), [**systemd-localed.service**(8)](/man/os/systemd/systemd-localed.service.8)

# [NOTES](#NOTES)

1\.

Boot Loader Interface

https://systemd.io/BOOT\_LOADER\_INTERFACE

systemd 262.2

---

Document: systemd-vconsole-setup.service(8) from systemd 262.2-r1 (Chainguard OS)
Source: https://github.com/systemd/systemd