systemd-vconsole-setup.service
systemd
systemd-vconsole-setup.service
8
systemd-vconsole-setup.service
systemd-vconsole-setup
Configure the virtual consoles
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-udevd8 during
VT console subsystem initialization. Also,
systemd-localed.service8
invokes it as needed when language or console changes are made.
Internally, this program calls
loadkeys1
and
setfont8.
Execute systemctl restart systemd-vconsole-setup.service in order to apply any manual
changes made to /etc/vconsole.conf.
See vconsole.conf5 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.exec1 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.service8:
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).
vconsole.font
vconsole.font_map
vconsole.font_unimap
The console font settings to apply. The matching options in
vconsole.conf and on the kernel command line take precedence over these
credentials.
See Also
systemd1,
vconsole.conf5,
loadkeys1,
setfont8,
systemd-localed.service8