Installing for macOS

MiKTeX can be installed via the Homebrew package manager.

Install Homebrew

If you don't already have Homebrew installed, you can install it by pasting

$ /usr/bin/ruby -e "$(curl -fsSL"

in a Terminal prompt. Please visit the Homebrew homepage for more detailed instructions.

Install MiKTeX

MiKTeX can then be installed by pasting these commands:

$ brew tap miktex/miktex
$ brew install miktex

in a Terminal prompt. The first command adds the MiKTeX repository to the list of formulae that Homebrew tracks, updates and installs from. The second command sets up a bare minimum MiKTeX, i.e., only executable files and manual pages.

From time to time, you should run

$ brew update
$ brew outdated miktex || brew upgrade miktex

This will update the MiKTeX executables, if there is a newer version available.

Installing packages

MiKTeX is pre-configured to install missing files on-the-fly, which allows you to keep your TeX installation reduced to the most necessary.

If you intend to work offline, you can upgrade your TeX installation by runnning

$ mpm --admin --package-level=basic --upgrade

This will upgrade to a TeX installation which consists of the most popular packages. If you want to install all available packages, then you can choose package level complete.

Directory Structure

TEXMF root directories:


User configuration data (UserConfig).


Recoverable user data (UserData).


Packages installed for the user (UserInstall).


System-wide configuration data (CommonConfig).


System-wide recoverable data (CommonData).


Packages installed for all users (CommonInstall).

Special directories:


MiKTeX binaries


MiKTeX internal binaries


MiKTeX shared objects


MiKTeX man pages