1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>vconsole.conf</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="vconsole.conf"><a name="vconsole.conf"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vconsole.conf — configuration file for the virtual console</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><p><code class="filename">/etc/vconsole.conf</code></p></div><div class="refsect1" title="Description"><a name="id472562"></a><h2>Description</h2><p>The <code class="filename">/etc/vconsole.conf</code> file
1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>vconsole.conf</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><style>
11
background-color: #c60f0f;
15
h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
18
</style><a href="index.html">Index </a>·
19
<a href="systemd.directives.html">Directives </a>·
20
<a href="../python-systemd/index.html">Python </a>·
21
<a href="../libudev/index.html">libudev </a>·
22
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 204</span><hr><div class="refentry"><a name="vconsole.conf"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>vconsole.conf — Configuration file for the virtual console</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/etc/vconsole.conf</code></p></div><div class="refsect1"><a name="idm259768387248"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>The <code class="filename">/etc/vconsole.conf</code> file
2
23
configures the virtual console, i.e. keyboard mapping
3
and console font.</p><p>The basic file format of the
24
and console font. It is applied at boot by
25
<a href="systemd-vconsole-setup.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-vconsole-setup.service</span>(8)</span></a>.</p><p>The basic file format of the
4
26
<code class="filename">vconsole.conf</code> is a
5
newline-separated list environment-like
27
newline-separated list of environment-like
6
28
shell-compatible variable assignments. It is possible
7
29
to source the configuration from shell scripts,
8
30
however, beyond mere variable assignments no shell
17
39
to override the console settings at boot.</p><p>Depending on the operating system other
18
40
configuration files might be checked for configuration
19
41
of the virtual console as well, however only as
20
fallback.</p></div><div class="refsect1" title="Options"><a name="id472617"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl><dt><span class="term"><code class="varname">KEYMAP=</code>, </span><span class="term"><code class="varname">KEYMAP_TOGGLE=</code></span></dt><dd><p>Configures the key
21
mapping table of for they
42
fallback.</p></div><div class="refsect1"><a name="idm259764617840"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="KEYMAP="><span class="term"><code class="varname">KEYMAP=</code>, </span><span class="term"><code class="varname">KEYMAP_TOGGLE=</code></span><a class="headerlink" title="Permalink to this term" href="#KEYMAP=">¶</a></dt><dd><p>Configures the key
22
44
keyboard. <code class="varname">KEYMAP=</code>
23
45
defaults to <code class="literal">us</code> if
25
47
<code class="varname">KEYMAP_TOGGLE=</code> can
26
be used to configured a second toggle
48
be used to configure a second toggle
27
49
keymap and is by default
28
unset.</p></dd><dt><span class="term"><code class="varname">FONT=</code>, </span><span class="term"><code class="varname">FONT_MAP=</code>, </span><span class="term"><code class="varname">FONT_UNIMAP=</code></span></dt><dd><p>Configures the console
50
unset.</p></dd><dt id="FONT="><span class="term"><code class="varname">FONT=</code>, </span><span class="term"><code class="varname">FONT_MAP=</code>, </span><span class="term"><code class="varname">FONT_UNIMAP=</code></span><a class="headerlink" title="Permalink to this term" href="#FONT=">¶</a></dt><dd><p>Configures the console
29
51
font, the console map and the unicode
30
font map. <code class="varname">FONT=</code>
32
<code class="literal">latarcyrheb-sun16</code>.</p></dd></dl></div></div><div class="refsect1" title="Example"><a name="id504825"></a><h2>Example</h2><div class="example"><a name="id504831"></a><p class="title"><b>Example 1. German keyboard and console</b></p><div class="example-contents"><p><code class="filename">/etc/vconsole.conf:</code></p><pre class="programlisting">KEYMAP=de-latin1
33
FONT=latarcyrheb-sun16</pre></div></div><br class="example-break"></div><div class="refsect1" title="See Also"><a name="id504851"></a><h2>See Also</h2><p>
34
<span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span>,
35
<span class="citerefentry"><span class="refentrytitle">loadkeys</span>(1)</span>,
36
<span class="citerefentry"><span class="refentrytitle">setfont</span>(8)</span>,
37
<span class="citerefentry"><span class="refentrytitle">locale.conf</span>(5)</span>
52
font map.</p></dd></dl></div></div><div class="refsect1"><a name="idm259764609712"></a><h2 id="Example">Example<a class="headerlink" title="Permalink to this headline" href="#Example">¶</a></h2><div class="example"><a name="idm259764609040"></a><p class="title"><b>Example 1. German keyboard and console</b></p><div class="example-contents"><p><code class="filename">/etc/vconsole.conf</code>:</p><pre class="programlisting">KEYMAP=de-latin1
53
FONT=latarcyrheb-sun16</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="idm259764606448"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
54
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
55
<a href="systemd-vconsole-setup.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-vconsole-setup.service</span>(8)</span></a>,
56
<a href="loadkeys.html"><span class="citerefentry"><span class="refentrytitle">loadkeys</span>(1)</span></a>,
57
<a href="setfont.html"><span class="citerefentry"><span class="refentrytitle">setfont</span>(8)</span></a>,
58
<a href="locale.conf.html"><span class="citerefentry"><span class="refentrytitle">locale.conf</span>(5)</span></a>,
59
<a href="systemd-localed.service.html"><span class="citerefentry"><span class="refentrytitle">systemd-localed.service</span>(8)</span></a>
38
60
</p></div></div></body></html>