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)

Only user related MiKTeX configuration and data files are modified.

Administrative mode

Only system-wide MiKTeX configuration and data files are modified. The utility should be run as the system administrator.

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.


This option is only available on UNIX system-like platforms. Configure MiKTeX:

  • kpsewhich is run to find existing TEXMF trees; the information is written to /var/lib/miktex-texmf/miktex/config/miktexstartup.ini, if administrative mode is turned on; otherwise the information is written to ~/.miktex/miktex/config/miktexstartup.ini

  • the system-wide (per-user) file name database is created, if administrative mode is turned on (off)


Create all memory dump files.


Dump the specified memory dump file.


Open the specified config file in an editor.


Force --mklinks to overwrite existing executables.


List all known METAFONT modes.


Create an executable for each known format.


Build the font map files.


Print what would be done. Nothing is changed.


Suppress screen output.


Register a TEXMF root directory.


Write a MiKTeX configuration report.


Unregister a TEXMF root directory.


Refresh the whole file name database.


Refresh the file name database for a specific TEXMF tree.


Print information on what is being done.


Print the version number and exit.