'\" t .TH "VCONSOLE\&.CONF" "5" "" "systemd 256.8" "vconsole.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" vconsole.conf \- Configuration file for the virtual console .SH "SYNOPSIS" .PP /etc/vconsole\&.conf .SH "DESCRIPTION" .PP The /etc/vconsole\&.conf file configures the virtual console, i\&.e\&. keyboard mapping and console font\&. It is applied at boot by udev using 90\-vconsole\&.rules file\&. You can safely mask this file if you want to avoid this kind of initialization\&. .PP The format of vconsole\&.conf is a newline\-separated list of environment\-like shell\-compatible variable assignments, ignoring comments and empty lines\&. 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\&. See \fBos-release\fR(5) for a detailed description of the format\&. .PP Note that the kernel command line options \fIvconsole\&.keymap=\fR, \fIvconsole\&.keymap_toggle=\fR, \fIvconsole\&.font=\fR, \fIvconsole\&.font_map=\fR, \fIvconsole\&.font_unimap=\fR may be used to override the console settings at boot\&. .PP Depending on the operating system other configuration files might be checked for configuration of the virtual console as well, however only as fallback\&. .PP /etc/vconsole\&.conf is usually created and updated using \fBsystemd-localed.service\fR(8)\&. \fBlocalectl\fR(1) may be used to instruct \fBsystemd\-localed\&.service\fR to query or update configuration\&. .SH "OPTIONS" .PP The following options are understood: .PP \fIKEYMAP=\fR, \fIKEYMAP_TOGGLE=\fR .RS 4 Configures the key mapping table for the keyboard\&. \fIKEYMAP=\fR defaults to "us" if not set\&. Specially, if "@kernel" is specified, no keymap will be loaded, i\&.e\&. the kernel\*(Aqs default keymap is used\&. The \fIKEYMAP_TOGGLE=\fR can be used to configure a second toggle keymap and is by default unset\&. .RE .PP \fIFONT=\fR, \fIFONT_MAP=\fR, \fIFONT_UNIMAP=\fR .RS 4 Configures the console font, the console map and the unicode font map\&. .RE .SH "KERNEL COMMAND LINE" .PP A few configuration parameters from vconsole\&.conf may be overridden on the kernel command line: .PP \fIvconsole\&.keymap=\fR, \fIvconsole\&.keymap_toggle=\fR .RS 4 Overrides \fIKEYMAP=\fR and \fIKEYMAP_TOGGLE=\fR\&. .sp Added in version 232\&. .RE .PP \fIvconsole\&.font=\fR, \fIvconsole\&.font_map=\fR, \fIvconsole\&.font_unimap=\fR .RS 4 Overrides \fIFONT=\fR, \fIFONT_MAP=\fR, and \fIFONT_UNIMAP=\fR\&. .sp Added in version 232\&. .RE .SH "EXAMPLE" .PP \fBExample\ \&1.\ \&German keyboard and console\fR .PP /etc/vconsole\&.conf: .sp .if n \{\ .RS 4 .\} .nf KEYMAP=de\-latin1 FONT=eurlatgr .fi .if n \{\ .RE .\} .SH "SEE ALSO" .PP \fBsystemd\fR(1), \fBsystemd-vconsole-setup.service\fR(8), \fBloadkeys\fR(1), \fBsetfont\fR(8), \fBlocale.conf\fR(5), \fBsystemd-localed.service\fR(8)