systemconfigurator(1) configures... all Linux distributions, all Linux platforms, all the time.


systemconfigurator [--cfgfile=filename]
[--stdin] [--verbose] [--debug] [--nocheck]
[--confignet] [--confighw]
[--configrd] [--configboot]
[--configtime] [--configuserexit]
[--runboot] [--configsi]
[--configall] [--configkeyboard]


Specify alternate config file. By default the program attempts to read /etc/systemconfig/systemconfig.conf. As all options can also be specified on the command line, no error is generated in the event that a config file can not be found.
Read config file from stdin. If this option is used, systemconfigurator will block while waiting on stdin for configuration data.
Give more information about what is happening on STDERR
Give debugging information about what is happening on STDERR. For the most information, use --verbose and --debug.
Do not sanity check systemconfigurator config file prior to execution of systemconfigurator. If your configuration references files/block devices that are not present on the file system, running with this option may generate a bootloader configuration that will render your operating system non-bootable. Use with caution.
configure networking scripts. This is pretty straight forward and just creates the right entries in /etc/sysconfig/network-scripts, /etc/rc.config, or /etc/init.d
Attempt to detect and configure hardware. This uses System Configurator's own hardware database to do the configuration, and only works for PCI scsi and network cards.

In the case that you want to use System Configurator's hardware setup, but need a different mapping of pci ids to modules, you can create overrides for System Configurator to use during detection.

Create a file /etc/systemconfig/hardware.lst in the image being installed. The format of this file is as follows:

  Vendor Id    Card Id    Type     Module
  ####         ####       xxx...   my_module


  8086   1010   ethernet   e1000

The Vendor Id and Card Id are the two 4 hex digit numbers identifying the card. The type can be one of scsi, ethernet, or tokenring. The module is the kernel module needed for the card.

Create initial ramdisks for kernels that need them, and do not have them. This will only work if the definitions for kernels have been specified, and the distribution has a supported native tool for ramdisk generation. SuSE, Red Hat, Mandrake, and Debian are known to work. The default ramdisk name will be sc-initrd-$kernelversion.gz
Configure boot loader. This only generates the bootloader configuration files, it does not install the bootloader. It will only run if kernel and boot stanzas are created.
Run/install the bootloader. This does nothing to the configuration files, it just runs the command needed to install the bootloader where it needs to go.
Configure those things that SystemImager needs. Currently this is exactly the same as "--confighw --confignet --runboot".
Configures timezone information for the machine. Defaults to on, but will only be run if the time stanza is specified.
Runs user exits after all other configuration is accomplished. This is done as a final step, and only if user exit stanzas are specified. It defaults to on.
Currently all this does is modify SLES7 installations to reset the keyboard to default settings instead of de-quertz which is set by the install rpms. Eventually this will be enhanced to configure keymapping files directly. It defaults to on, but may be turned off by adding --noconfigkeyboard to the commandline for those who wish to keep the de-quertz setting for SLES7.
Configure everything.


systemconfigurator provides a unified API to configure many aspects of Linux which differ between distributions and architectures.

System Configurator does the following:

  • Detect and Setup PCI NICS and Storage Devices (SCSI).
  • Setup Network Scripts
  • Setup Initrd (if required) and Bootloader
  • Configures time zone
  • Runs user specified user exits

System Configurator does this through the concept of ``footprinting''. For instance, each type of networking has a discrete footprint that will tell you which type is used on the computer. Instead of determining which Linux distribution is installed, and then figuring out which networking is used by that Linux distribution, System Configurator lets each networking type test to see if their footprint exists, and if so, does the right thing.

For more information about the configuration options available to systemconfigurator, please see SystemConfig::Config.

System Configurator is part of the System Installation Suite set of tools, which includes SystemImager and System Installer.


  Sean Dague <[email protected]>
  Donghwa John Kim <[email protected]>
  Dann Frazier <[email protected]>
  Joe Greenseid <[email protected]>
  Vasilios Hoffman <>
  Trey Belew <[email protected]>


$Log$ Revision 1.55 2005/03/25 23:50:45 sdague updated version to include new kernel detection

Revision 1.54 2005/03/24 23:22:40 sdague add modprobe.conf support, up version to 2.2.0 just for fun

Revision 1.53 2003/06/27 21:08:02 sdague fix some issues with hardware ordering make SuSE less verbose at times

Revision 1.52 2003/04/11 20:15:38 pramath Preparing for 2.0.6 Release.

Revision 1.51 2003/01/19 23:26:19 sdague Sean's 2 hour plane trip Includes update of email addresses for sean PREFERED attribute of [BOOT] SHORTHOSTNAME attribute of [NETWORK] and a few other niceities

Revision 1.50 2003/01/09 18:41:46 sdague changed all mailing list references to sisuite

Revision 1.49 2003/01/08 00:18:17 sdague updated to 2.0.4

Revision 1.48 2002/11/12 21:34:21 sdague use confignone

Revision 1.47 2002/11/12 21:33:40 sdague use confignone instead of @ARGV

Revision 1.46 2002/11/11 03:43:58 sdague change sanity test

Revision 1.45 2002/10/16 18:02:52 sdague new docs for systemconfigurator

Revision 1.44 2002/10/04 20:38:44 sdague update version to 2.0.0-1

Revision 1.43 2002/09/18 18:17:25 sdague new Grub code which should deal with devfs correctly and use new tools

Revision 1.42 2002/07/25 19:06:09 sdague backed off sc.spec to be 1.9.5-1

Revision 1.41 2002/06/13 21:36:28 sdague Updates to make Keyboard work in SLES 7 Time Zone stuff actually run SuSE8 networking actually run Better messages during network run under --verbose

Revision 1.40 2002/06/11 20:48:47 sdague Added 1.9.3 CHANGELOG Fixed a couple of SuSE ramdisk bugs Added more docs to sample.cfg

Revision 1.39 2002/06/10 18:15:01 sdague Some fixes for ramdisk versions

Revision 1.38 2002/06/05 18:42:47 sdague added userexit to main codepath

Revision 1.37 2002/04/02 19:56:43 sdague added new code

Revision 1.36 2002/03/18 19:47:43 sdague added code to Makefile.PL to make it set versions during build

Revision 1.35 2002/02/13 16:38:34 sdague added better error messages for rsync bugs and fixed a few lilo things

Revision 1.34 2001/10/22 00:52:40 sdague making final tweaks for 1.00 release

Revision 1.33 2001/10/13 20:29:14 sdague added Dann's name to the authors section of the main executable

Revision 1.32 2001/08/17 17:42:21 greekboy updated systemconfigurator to use --debug and --configrd

Revision 1.31 2001/08/07 15:56:16 sdague updated man page

Revision 1.30 2001/08/06 22:15:07 sdague changelog updated for 0.85 release systemconfigurator now has --version flag

Revision 1.29 2001/08/02 18:20:12 sdague pulled out references to Initrd code for now. All test cases work.

Revision 1.28 2001/08/02 17:40:12 donghwajohnkim Reverted calls to boot installer invocations

Revision 1.27 2001/07/31 22:59:25 sdague moved all test cases over to new SCConfig module got rid of AppConfig in the tree, as we no longer need it

Revision 1.26 2001/07/31 20:57:30 sdague systemconfigurator uses new neworking MANIFEST reflects new structure spec updated to 0.3.4 cleanups

Revision 1.25 2001/07/18 18:36:42 sdague Changed hardware module again.... exported reasonable api now

Revision 1.24 2001/07/16 19:37:44 sdague made systemconfigurator actually invoke verbose logging if specified

Revision 1.23 2001/07/16 18:56:51 sdague INSTALLSITELIB now set to /usr/lib/systemconfig. systemconfigurator program set to 'use lib' that directory.

Revision 1.22 2001/07/13 19:48:13 greekboy updated ramdisk method call since it is now different

Revision 1.21 2001/07/13 18:29:28 greekboy added support for creating ramdisks... now to make that support actually work

Revision 1.20 2001/07/13 14:18:14 sdague added support for RUNBOOT option

Revision 1.19 2001/07/12 18:08:28 greekboy oops..rolling back change, the problem was not here

Revision 1.18 2001/07/12 17:51:48 greekboy fixed error message about not being set

Revision 1.17 2001/07/09 18:59:08 donghwajohnkim Taking out ``Uninitialized ... '' warning message. In case the user does not specify ``ROOT'' option, $ENV{PATH} does not need to be manipulated.

Revision 1.16 2001/07/06 17:52:16 greekboy typo in pod

Revision 1.15 2001/07/06 17:46:34 greekboy added documentation for flags for bootloader

Revision 1.14 2001/07/05 17:35:29 donghwajohnkim Fixed method call to Boot::setup_boot().

Revision 1.13 2001/06/19 18:58:39 sdague added path manipulation

Revision 1.12 2001/06/05 15:24:28 greekboy fixed typo in pod doc

Revision 1.11 2001/05/24 16:20:13 jgreenseid Made some changes to the pod docs.

Revision 1.10 2001/05/22 17:02:02 sdague attempting to add Log keyword


Hey! The above document had some coding errors, which are explained below:
Around line 40:
'=item' outside of any '=over'
Around line 144:
You forgot a '=back' before '=head1'