Section: Console-setup User's Manual (1)
setupcon - sets up the font and the keyboard on the console
is a program for fast and easy setup of the font and the keyboard on
the console. Most of the time you invoke
without arguments. The keyboard configuration is specified in
The font configuration is specified in
for instructions how to configure these two files.
If you have to switch often between different encodings, keyboards or
languages, you can prepare several alternative configuration files for
Suppose that most of the time you will use Greek language with Greek
keyboard layout, but sometimes you need to type in German with German
keyboard layout. In this situation you should customize the main
(keyboard and console-setup)
for Greek. Also, create alternative configuration files for German
keyboard.german and console-setup.german.
Then in order to configure the console for Greek you will simply run
the command with no arguments:
and in order to configure the console for German you will use
Specifies which configuration file to use. With no variant,
the configuration files of
console-setup and keyboard.
On the other hand, if you use e.g.
then the configuration files are
console-setup.chukchi and keyboard.chukchi.
In this way you can have easy access to several different
configurations - for example one for the Chukchi language and another
for the default configuration.
- -v, --verbose
Be more verbose. Use this option if something goes wrong or while
experimenting with the configuration files.
- -k, --keyboard-only
Setup the keyboard only, do not setup the font or the terminal. On
Linux it is enough to do this configuration only once.
- -f, --font-only
Setup the font only, do not setup the keyboard or the terminal. On
Linux this configuration should be repeated each time a new console
driver is activated (for example when the frame buffer becomes
- -t, --terminal-only
Setup the terminal only, do not setup the keyboard or the font.
Setup the only the current virtual terminal.
Do not check whether we are on the console. Notice that you can be
forced to hard-reboot your computer if you run
with this option and the screen is controlled by a X server.
This option can be useful if you want to use
early in the boot process while
is not yet mounted and the required data are not available. This
option will make
copy the required files in
in order to make them available before
is mounted. If you use
early in the boot process, then you should run it with this option
after every change of the console configuration.
The same as
but does not setup anything. This option can be useful if you want to
save the required files while the screen is controlled by a X server.
- --save-keyboard FILE
For use by initrd builders. Do not configure anything. Save an
usable keyboard layout in
- --setup-dir DIR
For use by initrd builders. Do not configure anything. Arrange in
everything necessary in order to configure the console. The file
lists all binaries the initrd builder has to install in the initrd
image. All other files in
have to be copied unchanged in the initrd. In order to configure the
console one has to run the script
- -h, --help
Display usage information.