latex Getting started with latex Installation and Setup


Example

You can choose between major distributions of LaTeX:

  • TeX Live (Windows, Linux, and OS X), the standard, cross-platform distribution.
  • MacTeX (Mac) A packaged version of TeX Live made for OS X with some Mac-specific tools
  • MiKTeX (Windows) A separate distribution entirely that

All distributions are more or less equivalent in an ideal world. TeX Live has the advantage of being available on all platforms and thus has much better community support. MiKTeX can take advantage of Windows-specific features. For licensing reasons, MiKTeX will also distribute a few packages that TeX Live will not.

In all cases, the full install is recommended. Specifically, using MiKTeX's download-on-command feature will hang/crash many editors.

Installation

Windows (TeXLive)

  1. Download the most recent TeXLive install-tl-windows.exe from their website.
  2. Run install-tl-windows.exe and follow the instructions.

Windows (MiKTeX)

  1. Download the most recent MiKTeX installer from their website.
  2. Run the installer and follow the instructions.

Mac OS X (TeXLive)

  1. Download the most recent MacTeX from their website.
  2. Run MacTeX.pkg and follow the instructions.

Linux (TeXLive)

Linux users have two options:

  1. Install via your distribution's package manager (usually several releases behind)
  2. Install from upstream (released yearly, updated often)

Using Package Managers

  • Arch Linux: pacman -S texlive-most
  • Debian/Ubuntu/Mint: apt-get install texlive-full
  • Fedora: yum install texlive

Note that using this method means that you will be dependent on that package's maintainer for the distribution for updates. These packages will often be several releases behind the most recent distribution, often meaning critical updates will be missing. It's almost always best to install from upstream. Also note that the distribution's package manager will probably not recognize the direct installation and could try to install it when one installs other related support packages.

Installing from Upstream

  1. Download the most recent TeXLive install-tl-unx.tar.gz from their website.

  2. Extract the files from the archive with tar -zxvf install-tl-unx.tar.gz.

  3. Change into the downloaded folder with cd install-tl-unx.

  4. Run ./install-tl and follow the instructions.

    TeXLive should now be installed under /usr/local/texlive/YEAR/, where YEAR is the four digit year (e.g. 2016). In this way, it is possible to have multiple TeXLive versions alongside each other and switch between them by changing your PATH variable.

    Open this folder and check the bin folder. It should contain a subfolder, which (depending on your platform) will be something like i386-linux or x86_64-linux.

  5. Add the TeX Live binary folder to your path with

    EXPORT PATH=/usr/local/texlive/YEAR/bin/PLATFORM:$PATH
    

    where YEAR is the four digit year (e.g. 2016), and PLATFORM is your platform (e.g. x86_64-linux).

Test Installation

The LaTeX installation is now complete. To test it, create a new file with your favorite text editor, name it test.tex and add the following content:

\documentclass{article}
\begin{document}
  Hello World!
\end{document}

Now, open the console or terminal, navigate to the folder where you saved test.tex and run

pdflatex test

(Note that your editor may have facilities to run this for you.)

This creates several new files, including test.pdf. This is the output document, and looks like this:

Resulting PDF file from compiling `test.tex

Congratulations, you have successfully installed LaTeX, and created your first LaTeX document!