Copyright © 2001–2017 Christian Schenk
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
This is the official MiKTeX FAQ. It is available in the following formats:
What is MiKTeX?
MiKTeX is an implementation of TeX & Friends for Windows, macOS and Linux.
Is there a home page?
Yes. The official project page is https://miktex.org/.
Which Windows version is required for running MiKTeX?
MiKTeX requires one of the following Windows operating systems:
Which macOS version is required for running MiKTeX?
MiKTeX requires one of the following macOS operating systems:
Which Linux version is required for running MiKTeX?
MiKTeX requires one of the following Linux operating systems:
Am I allowed to redistribute MiKTeX?
The MiKTeX distribution is a conglomerate of many components. To the best of my knowledge, all components meet the requirements of the Debian Free Software Guidelines. This means that MiKTeX may be freely used, copied, modified, and redistributed.
Please visit this page, for more information
Am I allowed to sell MiKTeX?
Yes, as long as you honor the licenses of the MiKTeX components. For example, many of the components are licensed under the GPL, which requires you to make their source code available.
How do I download MiKTeX on Windows?
How do I install MiKTeX on Windows?
You use one of the installers to set up a MiKTeX installation on Windows:
For more information, read the tutorial Install MiKTeX on Windows.
How do I install MiKTeX on macOS?
You use the Homebrew package manager to set up a MiKTeX installation on macOS:
brew tap miktex/miktex brew install miktex
For more information, read the tutorial Install MiKTeX on macOS.
How do I install MiKTeX on Linux?
What is the “Basic MiKTeX” installer?
The “Basic MiKTeX Installer” sets up a basic MiKTeX system. Additional packages can be installed on-the-fly. This has the advantage of keeping a minimal MiKTeX system.
What is the MiKTeX Net Installer?
This installer serves two purposes:
Is MiKTeX available on CD or DVD?
Yes, MiKTeX is available on DVD-R (see this page).
The DVD-R contains a live MiKTeX system, which makes it possible to run MiKTeX directly from the DVD-R. Alternatively, the DVD-R allows you to install MiKTeX on your hard-disk.
Is it possible to download MiKTeX without the wizard?
You can use your favorite download tool to get the contents
How do I get support?
Please visit https://miktex.org/support, for an overview of available support options.
Is there a mailing list?
How can I join the mailing list?
To join the list, direct your browser to the MiKTeX-Users Info Page and fill out the form.
You will receive instructions (via email) on how to use the mailing list.
How can I read old articles?
To see the collection of prior postings to the MiKTeX-Users list, visit the MiKTeX-Users Archives.
How can I leave the mailing list?
Visit the MiKTeX-Users Info Page and enter you subscription email address to change your subscription status.
I have installed MiKTeX. How do I use it?
If you have never used TeX before: we recommend that, first of all, you work through a TeX/LaTeX tutorial. A good starting point is this page.
MiKTeX doesn't differ very much from any other TeX system you might have used before. Typesetting with MiKTeX involves these steps:
Which program should I use to edit LaTeX documents?
The MiKTeX distribution includes TeXworks, a simple environment for editing TeX/LaTeX documents.
How do I update my MiKTeX system?
You use MiKTeX Update Wizard ( → → ) to update installed packages. For more information, read the section Installing Updates in the MiKTeX manual.
Which is the best directory to keep
MiKTeX Package Manager takes care of the proper installation of well known LaTeX packages.
If (for some reason) you have to install a package by hand, then
you should copy the input files into the directory
For more information, read the section Integrating Local Additions in the MiKTeX manual.
How do I add new languages to the LaTeX format file?
You use MiKTeX Options to add new languages. For more information, read the section Selecting Hyphenation Tables in the MiKTeX manual.
How do I refresh the file name database?
If you have a command-prompt window open:
If you prefer to use the graphical user interface:
How do I install package
For the impatient: try it with
mpm --verbose --install
If the package turns out to be missing in the MiKTeX package repository, then you must install it manually. See also Q: 2.
Why is package
There are two possible reasons:
How can I find out which package the file
The search facility in MiKTeX Package Manager allows you to
enter all or part of a file name. For example, enter
Why does latex use pdfTeX (and not TeX)?
pdfTeX is now the default typesetting engine. The DVI output should be identical to that of TeX.
How can I change the output file name?
For example, you would run
pdflatex --job-name=dog cat.tex
to create the PDF file
How can I change the output directory?
For example, you would run
pdflatex --output-directory=C:\temp mydoc.tex
to deposit the output file (
How do I insert source specials into the DVI file?
For example, run the
latex --src mydoc.tex
How do I produce PostScript for distilling to PDF?
For example, the command
dvips -Ppdf mydoc.dvi
causes Dvips to use
How can I navigate to a random page?
You can type the page number followed by g to jump to a certain page. For example, typing the key sequence 220g will direct Yap to page 220.
I want to see what's going on backstage. Where does MiKTeX write the trace messages?
MiKTeX programs log their actions into the DebugView window, if you specify suitable trace options.
How do I use the DebugView window?
First of all, you will need the DebugView utilitt, which is a part of the Windows Sysinternals suite. To download. To download DebugView, visit the Windows Sysinternals page.
How do I set trace options?
Set the environment variable
will trace all errors and file accesses. For more information, read the section Trace Streams in the MiKTeX manual.