NAME

       setupcon - sets up the font and the keyboard on the console

SYNOPSIS

       setupcon [OPTION]... [VARIANT]

DESCRIPTION

       setupcon is a program for fast and easy setup of the font and the keyboard on the console.
       Most of the time you invoke setupcon without arguments.   The  keyboard  configuration  is
       specified in ~/.keyboard or /etc/default/keyboard.  The font configuration is specified in
       ~/.console-setup or /etc/default/console-setup.  Consult keyboard(5) and  console-setup(5)
       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 setupcon.  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  configuration files (keyboard and console-setup) for Greek.  Create also alternative
       configuration files for German named keyboard.german and  console-setup.german.   Then  in
       order  to  configure  the  console  for  Greek  you  will  simply  run the command with no
       arguments: setupcon and in order  to  configure  the  console  for  German  you  will  use
       setupcon german.

OPTIONS

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

       -f, --font-only
              Setup the font only, do not setup the keyboard.

       --force
              Do not check whether we are on the console.  Notice that you can be forced to hard-
              reboot  your  computer  if  you  run  setupcon  with  this option and the screen is
              controlled by a X server.

       --save This option can be useful if you want to use setupcon early  in  the  boot  process
              while /usr is not yet mounted and the required data are not available.  This option
              will make setupcon copy the required files in /etc/console-setup/ in order to  make
              them  available  before  /usr  is  mounted.   If you use setupcon early in the boot
              process, then you should run it with this option after every change of the  console
              configuration.

       --save-only
              The  same as --save, but does not setup the keyboard and the font.  This option can
              be useful if you want to save the required files while the screen is controlled  by
              a X server.

       -h, --help
              Display usage information.

       VARIANT
              Specifies  which  configuration file to use.  By default the configuration files of
              setupcon are named console-setup and keyboard but  if  you  use  e.g.   chukchi  as
              VARIANT   then   the   configuration   files   will  be  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.

FILES

       ~/.console-setup
       ~/.keyboard
       /etc/default/console-setup
       /etc/default/keyboard
       /etc/default/console-setup.VARIANT
       /etc/default/keyboard.VARIANT
       /etc/console-setup/

SEE ALSO

       keyboard(5), console-setup(5)