initexmf — MiKTeX configuration utility


initexmf [option...]


initexmf is used to configure MiKTeX.

User mode vs. administrative mode

This utility can be run in two modes:

User mode (default)

MiKTeX operates on user-scoped configuration and data files.

Administrative 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 administrative mode with the --admin option. For example, if you want to update the system-wide file name database, you invoke the utility as follows:

> initexmf --admin --update-fndb



Run in administrative 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.


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


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


Create all memory dump files.


Dump the specified memory dump file.


Open the specified config file in a text editor.


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


Engine to be used when generating format files.


Force --mklinks to overwrite existing executables.


List all known formats.


List all known METAFONT modes.


Create all possible links.


Create links for the specified category, which must be one of:


Create links from format names to TeX engines. For example, latex.exe will become a link to miktex-tex.exe and invoking latex.exe will cause TeX to load the format file latex.fmt.


Create links from standard program names to miktex- executables. For example, tex.exe will become a link to miktex-tex.exe.


Create executable links from script names to script wrappers. For example, latexmk.exe will become a link to the internal Perl wrapper runperl.exe and invoking latexmk.exe will eventually execute the Perl script


Build the font map files.


Print what would be done. Nothing is changed.


Suppress screen output.


Register a TEXMF root directory.


Remove the links which were created by --mklinks.


Write a MiKTeX configuration report.


Set a configuration value.


Show a configuration value.


Unregister a TEXMF root directory.


Refresh the whole file name database.


Refresh the file name database for a specific TEXMF tree.


Register user root directories.


Print information on what is being done.


Print the version number and exit.