initexmf

## Name

initexmf — MiKTeX configuration utility

## Synopsis

`initexmf` [`option`...]

## Description

initexmf can be used to configure MiKTeX.

## User mode vs. administrator mode

This utility can be run in two modes:

User mode (default)

  MiKTeX operates on user-scoped configuration and data files.

Administrator mode

  Only system-wide MiKTeX configuration and data files are modified, assuming that the MiKTeX setup is shared by all users. The utility must be run with administrator privileges.

By default, the utility runs in user mode. You can turn on administrator mode with the `--admin` option.

## Options

`--admin`

  Run in administrator mode:

  - Operate on the system-wide MiKTeX configuration data store.

  - Install packages for all users.

  Using this option requires a shared MiKTeX setup, i.e., MiKTeX must have been set up for all users. The program must be run with administrator privileges.

`--default-paper-size=`paper``

  Set the default paper size. `paper` must be `a4` or `letter`.

`--disable-installer`

  Disable automatic installation of packages. Specifying this option overrules settings in the MiKTeX configuration data store.

`--edit-config-file=`configfile``

  Open the specified config file in a text editor.

`--enable-installer`

  Enable automatic installation of packages. Specifying this option overrules settings in the MiKTeX configuration data store.

`--list-modes`

  List all known METAFONT modes.

`--print-only`

  Print what would be done. Nothing is changed.

`--quiet`

  Suppress screen output.

`--register-root=`dir``

  Register a TEXMF root directory.

`--report`

  Write a MiKTeX configuration report.

`--set-config-value=[`section`]`valuename`=`value``

  Set a value to be stored in the MiKTeX configuration data store (see miktex.ini(5)).

`--show-config-value=[`section`]`valuename``

  Print a value from the MiKTeX configuration data store (see miktex.ini(5)).

`--unregister-root=`dir``

  Unregister a TEXMF root directory.

`--user-roots=`directories``

  Register user root directories.

`--verbose`

  Print information on what is being done.

`--version`

  Print the version number and exit.

## See also

miktex(1), miktex.ini(5)