Getting MiKTeX

Install on macOS

To set up a TeX/LaTeX system on macOS, download and open this disk image. Then drag the MiKTeX icon onto the Applications folder.

Please read the tutorial, if you want step-by-step guidance.

Install on Linux

MiKTeX is available for selected Linux distributions.

Installing MiKTeX on Linux involves these steps:

1. Register the GPG key with which MiKTeX installation packages and metadata is signed. The key ID is: D6BC243565B2087BC3F897C9277A7293F59E4889
2. Register the installation source which contains the MiKTeX installation package. The installation source depends on the Linux distribution version.
3. Use the package management system to install MiKTeX.
4. Finish the setup.
5. Upgrade your TeX distribution. This is an optional step.

Please click a tab to get instructions for your Linux distribution:

•  Ubuntu
•  Mint
•  Debian
•  Fedora
•  CentOS
•  openSUSE

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys D6BC243565B2087BC3F897C9277A7293F59E4889

echo "deb http://miktex.org/download/ubuntu focal universe" | sudo tee /etc/apt/sources.list.d/miktex.list

echo "deb http://miktex.org/download/ubuntu bionic universe" | sudo tee /etc/apt/sources.list.d/miktex.list

echo "deb http://miktex.org/download/ubuntu xenial universe" | sudo tee /etc/apt/sources.list.d/miktex.list

sudo apt-get update
sudo apt-get install miktex

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys D6BC243565B2087BC3F897C9277A7293F59E4889

echo "deb http://miktex.org/download/ubuntu focal universe" | sudo tee /etc/apt/sources.list.d/miktex.list

echo "deb http://miktex.org/download/ubuntu bionic universe" | sudo tee /etc/apt/sources.list.d/miktex.list

echo "deb http://miktex.org/download/ubuntu xenial universe" | sudo tee /etc/apt/sources.list.d/miktex.list

sudo apt-get update
sudo apt-get install miktex

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys D6BC243565B2087BC3F897C9277A7293F59E4889

echo "deb http://miktex.org/download/debian stretch universe" | sudo tee /etc/apt/sources.list.d/miktex.list

sudo apt-get update
sudo apt-get install miktex

sudo rpm --import "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0xD6BC243565B2087BC3F897C9277A7293F59E4889"

sudo curl -L -o /etc/yum.repos.d/miktex.repo https://miktex.org/download/fedora/32/miktex.repo

sudo curl -L -o /etc/yum.repos.d/miktex.repo https://miktex.org/download/fedora/30/miktex.repo

sudo curl -L -o /etc/yum.repos.d/miktex.repo https://miktex.org/download/fedora/28/miktex.repo

sudo dnf update
sudo dnf install miktex

sudo rpm --import "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0xD6BC243565B2087BC3F897C9277A7293F59E4889"

sudo curl -L -o /etc/yum.repos.d/miktex.repo https://miktex.org/download/centos/8/miktex.repo

sudo dnf update
sudo dnf install miktex

sudo rpm --import "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0xD6BC243565B2087BC3F897C9277A7293F59E4889"

sudo curl -L -o /etc/zypp/repos.d/miktex.repo https://miktex.org/download/opensuse/15/miktex.repo

sudo zypper update
sudo zypper install miktex

d. Finish the setup

Before you can use MiKTeX, you have to finish the setup. You can use MiKTeX Console or, if you prefer the command line, miktexsetup.

Search&click the MiKTeX Console icon to start MiKTeX Console:

Now is the time to make a decision:

Do you want to set up a private (for you only) TeX installation, or do you want to set up a shared (system-wide) TeX installation?

You probably want to choose the first option.

The second option makes sense if you are the administrator of a multi-user system. If this is the case and if you expect that some of your users would like to work with MiKTeX, then you should install MiKTeX system-wide.

Click one of the two buttons if you have made your decision.

Run

miktexsetup finish

to finish with a private (for you only) TeX installation. Executables like lualatex will be installed in ~/bin.

Run

sudo miktexsetup --shared=yes finish

to finish with a shafred (system-wide) TeX installation. Executables like lualatex will be installed in /usr/local/bin.

You also may want to enable automatic package installation:

initexmf --set-config-value [MPM]AutoInstall=1

Or, if you have a shared installation:

sudo initexmf --admin --set-config-value [MPM]AutoInstall=1

e. Upgrade

If you have just installed MiKTeX, then you have the option to upgrade your installation to a standard TeX system. Just click the Upgrade button. Please be aware that this starts a ~200MB download.

Alternatively, you can turn on the auto-install feature and let MiKTeX install missing packages on-the-fly. This will help you to keep your TeX installation as minimal as possible (“Just enough TeX”).

See also

FAQ: Is it possible to install MiKTeX and TeX Live side-by-side?

Docker image

The Docker image allows you to run MiKTeX on any computer that supports Docker. You can obtain the image from Docker hub:

docker pull miktex/miktex

Create a volume:

docker volume create --name miktex

Provided that your main input file is located in the current working directory, you can run pdflatex as follows:

docker run -ti \
  -v miktex:/miktex/.miktex \
  -v `pwd`:/miktex/work \
  miktex/miktex \
  pdflatex main.tex

Please read the tutorial, if you want step-by-step guidance.

Please beware that the Docker image is still in an experimental stage.

All downloads