Manage your TeX installation with MiKTeX Console

Last edited: 2/26/2018 6:04:03 PM

MiKTeX Console Icon

MiKTeX Console is the tool you use to manage your TeX installation. Most often you will use it to get package updates.

Start MiKTeX Console

MiKTeX Console is a desktop application, i.e, it can be started in the usual way by searching and clicking MiKTeX Console in the application launcher (Windows start menu, Unity Dash, macOS Launchpad).

Operation mode

By default, MiKTeX Console runs in user mode and so operates on your private MiKTeX configuration. If you have installed MiKTeX system-wide, this is not necessarily what you want. For this reason, MiKTeX Console asks you to switch/confirm the operation mode, if you have a system-wide setup:

  1. Restart as administrator causes MiKTeX Console to restart with elevated privileges. This allows you to operate on the system-wide part of the TeX installation.
  2. I want to stay in user mode tells MiKTeX Console that you want to work on the private part of the TeX installation.

Installing updates

You can update your MiKTeX installation:

  1. Click Updates to navigate to the updates page.
  2. Click Check for Updates to search for updatable packages.
  3. After some seconds, you will a window similar to this:

MiKTeX Console: update

  1. Click Update now to start the installation of updates.

Setting the preferred paper format

  1. Click Settings to navigate to the settings page.
  2. Click the General tab.
  3. Select a paper format.

Refreshing the file name database

To speed up file search, MiKTeX makes use of a file location cache. This is called the file name database (FNDB).

It is necessary that you refresh the FNDB whenever you manually install TeX/LaTeX-related files in a user-managed TEXMF directory:

  1. Open the Tasks menu.
  2. Click Refresh file name database.

Automatic package installation

MiKTeX has the ability to automatically install missing packages.

You can turn this feature on or off. And you can let MiKTeX ask you each time a package has to be installed:

  1. Click Settings to navigate to the settings page.
  2. Click the General tab.
  3. Click one of the radio buttons:
    • Ask me
    • Always install missing packages on-the-fly
    • Never install missing packages on-the-fly

Registering a user-managed TEXMF root directory

If you have files that you want to integrate into the MiKTeX setup, you can register a user-managed TEXMF root directory:

  1. Click Settings to navigate to the settings page.
  2. Click the Directories tab.
  3. Click the Add toolbar button.
  4. Select the TEXMF root directory you want to add.

Reset the TeX installation to factory defaults (Mac, Linux)

If you decide to uninstall MiKTeX, you should first reset the TeX installation to the factory defaults:

  1. Click Cleanup to navigate to the cleanup page.
  2. Click Reset the TeX installation to factory defaults.

This resets the TeX installation to the initial state. You can now uninstall MiKTeX.