The MiKTeX Installation Procedure

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Free Software Foundation.


Table of Contents

About this document
Introduction
Prerequisites
Choosing a Package Set
Downloading MiKTeX
Installing MiKTeX
Troubleshooting the Setup Process

About this document

This document describes the MiKTeX installation procedure. The latest version of this document is available from CTAN (PDF, HTML).

Introduction

Four steps are necessary to install MiKTeX:

  1. Check to see if the prerequisites are met.

  2. Choose a package set.

  3. Download MiKTeX.

  4. Install MiKTeX.

Prerequisites

MiKTeX runs on all current Windows platforms.

MiKTeX Setup Wizard does not install any operating system components (such as comctl32.dll). It is taken for granted, that all required system components exist, either because they are a part of the operating system, or because they were installed by an operating system update (service pack).

The following system components are required by MiKTeX:

comctl32.dll

Version 5.80.2614.3600 (or later) of the Common Controls DLL must be installed. This is the case if the operating is Windows Me or Windows XP. For older operating systems, it might be necessary to get the DLL from Microsoft.

wininet.dll

Version 4.70.0.1300 (or later) of the Internet Extensions DLL must be installed. It is a part of Internet Explorer 4.0 (or later).

MiKTeX Setup Wizard displays a message and quits, if one of the required system components is missing.

Choosing a Package Set

You can choose between three package sets: “Small MiKTeX”, “Large MiKTeX” and “Total MiKTeX”.

Small MiKTeX

This is a basic MiKTeX system which gets you started.

Large MiKTeX

This gives you the most important macro packages and fonts.

Total MiKTeX

This includes all available packages.

Choose “Small MiKTeX”, if you are downloading MiKTeX over a slow Internet connection or if you want to conserve disk space. It is possible to configure MiKTeX in such a a way, that missing packages are automatically installed later (during run-time).

Downloading MiKTeX

You can download MiKTeX either with the help of MiKTeX Setup Wizard (setup.exe), or manually with the help of an FTP client. This installation guide covers the wizard method, because it is the recommended method for most users. See the MiKTeX FAQ, for a detailed description of the FTP method.

  1. Download the latest version of the wizard from the SourceForge.net download server.

  2. Start the wizard (setup.exe).

    You will be presented with the welcome page:

    Click Next > to advance to the next page.

  3. Click on the Download only radio button:

    Click Next > to go to the next page.

  4. Click on the package set that you wish to download:

    Click Next > to go to the next page.

  5. Choose a download location:

    MiKTeX Setup Wizard will download packages from a remote package repository. Choose a repository which is located in the closest network proximity to your location.

    Click Next > to go to the next page.

  6. Specify the location of the local package repository:

    Downloaded packages will be stored in the local package repository, a directory on your computer.

    Later you will run the wizard again to install MiKTeX from here.

    Click Next > to go to the next page.

  7. Review the download settings:

    Click < Back, if you want to change the settings. Click Next > to start the download process.

  8. Two progress bars indicate the progress of the download operation:

    Click Next > when the download is complete.

  9. You will see the final wizard page:

    Click Finish to close the wizard.

Installing MiKTeX

You install MiKTeX with the help of MiKTeX Setup Wizard:

  1. Download the latest version of the wizard from the SourceForge.net download server.

  2. Login as Administrator, if you want to set up a shared MiKTeX system.

  3. Make sure that no MiKTeX application is running.

  4. Start the wizard (setup.exe).

    You will be presented with the welcome page:

    Click Next > to go to the next page.

  5. Click on the Install radio button:

    Click Next > to go to the next page.

  6. Click on the package set you wish to install:

    Click Next > to go to the next page.

  7. Choose if you want to set up a shared MiKTeX system or if you want to run MiKTeX privately:

    Click Next > to go to the next page.

  8. Specify the location of the local package repository:

    MiKTeX will be installed from a local package repository, i.e., a directory on your computer which mirrors the contents (or parts of it) of a remote package repository. You have created the local package repository during the download stage.

    Click Next >to go to the next page.

  9. Accept the suggested installation directory or enter your own choice:

    Click Next > to go to the next page.

  10. Accept the suggested program folder name or enter your own choice:

    Click Next >, to go to the next page.

  11. Accept the suggested path to the local TEXMF directory or enter your own choice:

    Click Next > to go to the next page.

  12. Choose if you want to incorporate additional TEXMF directories:

    You can safely defer the decision. TEXMF directories can be configured later with the help of MiKTeX Options.

    Click Next > to go to the next page.

  13. Review the setup settings:

    Click < Back, if you want to change the settings. Click Next > to start the installation process.

  14. Two progress bars indicate the progress of the installation process:

    Click Next > when the installation is complete.

  15. You will see the final wizard page:

    Click Finish to close the wizard.

Troubleshooting the Setup Process

MiKTeX Setup Wizard logs all actions into the DebugView window. You need to download and install DebugView, if you intend to troubleshoot setup related problems.

To download DebugView, visit the DebugView page and follow the download/installation instructions.

To create a trace, start DebugView prior to the setup wizard.

In addition, the wizard reports some actions into a log file. The name of the log file is setup-currentdate.log. Search for this file in the config directory (usually C:\texmf\miktex\config\).