install-tl-unx

Introduction to TeX Live and its installer

The TeX Live package is a comprehensive TeX document production system. It includes TeX, LaTeX2e, LuaLaTeX, Metafont, MetaPost, BibTeX and many other programs; an extensive collection of macros, fonts and documentation; and support for typesetting in many different scripts from around the world.

This page is for people who wish to use the binary installer to provide the programs, the scripts, and a lot of supporting files and documentation. The installer is updated frequently, so any published md5sum will soon be out of date. Newer versions of the installer are expected to work with these instructions, for so long as they install to a 2024/ directory.

There are two reasons why you may wish to install the binaries in BLFS: either you need a smaller install (e.g. at a minimum plain TeX without LaTeX, ConTeXt, etc), or you wish to use tlmgr to get updates whilst this version is supported (typically, until March of the year after it was released). For the latter, you might prefer to install in your /home directory as an unprivileged user, and to then make corresponding changes to the PATH in your ~/.bashrc or equivalent.

[Note]

Note

If you wish to use ConTeXt with luametatex (most of the old MKII and MKIV code was removed from TeX Live 2023 by the ConTeXt developer), using the binary is probably the easiest option. The source no-longer ships with TeX Live and is poorly adapted to building with systems except those running Mac and Windows. See comments 1 to 5 of #17823.

[Note]

Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

Package Information

  • Download (HTTP): https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz

  • Download MD5 sum: Varies frequently

  • Download size: 5.5 MB

  • Estimated disk space required: 85 MB for plain TeX, typically 2 to 4 MB for latex and later engines, 8.6 GB if everything is included

  • Estimated build time: varies, depending on network speed and traffic

Recommended

Recommended (at runtime)

The binary version of asy is linked to libGLX.so.0 from libglvnd, but installing that will break future updates of BLFS packages such as Mesa-24.2.7. Work around that by creating a symlink as the root user:

ln -sv libGL.so.1 /usr/lib/libGLX.so.0
[Note]

Note

As always with contributed binary software, it is possible that the required dependencies may change when the installer is updated. In particular, these dependencies have only been checked on x86_64.

Python2 is used by the unmaintained ebong CTAN module (intended for writing Bengali in Rapid Roman Format). /usr/bin/python is also in the shebang line for the latex-papersize and lilyglyphs scripts, and documentation at CTAN says both modules have been updated to work with python3. In pythontex there are scripts to invoke python3 or python2 according to the system's version of python. Ruby-3.3.6 is used by two scripts, one is for pTex (Japanese vertical writing) and the other is match_parens which might be generally useful. The perl module Tk, which needs to be run from an X11 session to run the tests and requires Tk-8.6.15 is used by one of the scripts for ptex and is needed for texdoctk (a GUI interface for finding documentation files and opening them with the appropriate viewer). ps2pdf, from ghostscript-10.04.0, is used by some utilities and scripts.

Binary Installation of TeX Live

The TeX Live set of programs with its supporting documents, fonts, and utilities is very large. The upstream maintainers recommend placing all files in a single directory structure. BLFS recommends /opt/texlive.

[Note]

Note

If you have chosen to install the binary as a normal user, the directory for the prefix needs to be writable by that user. The root user can chown /opt/texlive/2024 to that user before the user starts the install. If any later change in that directory is made by the root user, that will change the ownership, which breaks usage by normal users.

As with any other package, unpack the installer and change into its directory, install-tl-<CCYYMMDD>. This directory name changes when the installer is updated, so replace <CCYYMMDD> by the correct directory name.

[Note]

Note

The distribution binaries installed below may use static linking for general linux system libraries. Additional libraries or interpreters as specified in the dependencies section do not need to be present during the install, but the programs that need them will not run until their specific dependencies have been installed.

With all contributed binary software, there may be a mismatch between the builder's toolchain and your hardware. In most of TeX this will probably not matter, but in uncommon corner cases you might hit problems. For example, if your x86_64 processor does not support 3dnowext or 3dnow, the 2014-06-28 binary failed in conTeXt when running LuaTeX, although lualatex worked, as did the i686 binaries on the same machine. In such cases, the easiest solution is to install texlive from source. Similarly, the x86_64 binary version of asy runs very slowly when creating 3-D diagrams.

Now, as the root user:

TEXLIVE_INSTALL_PREFIX=/opt/texlive ./install-tl

This command is interactive and allows selection or modification of platform, packages, directories, and other options. The full installation scheme will require about 4.9 gigabytes of disk space. The time to complete the download will depend on your internet connection speed and the number of packages selected.

It has been established by Debian that the python scripts in latex-make will work with python3, so update them to invoke that by running the following command as the root user:

for F in /opt/texlive/2024/texmf-dist/scripts/latex-make/*.py ; do
  test -f $F && sed -i 's%/usr/bin/env python%/usr/bin/python3%' $F || true
done

Command Explanations

test -f $F && sed ...: in a small install these files might not be present, so test if they exist and if not return 'true' to avoid any error if this command has been copied into one of your own install scripts.

./install-tl --location http://mirror.aut.ac.nz/CTAN/systems/texlive/tlnet/: use a variation of this if you wish to use a different mirror, for example, because you are in New Zealand but the installer chooses to use an Australian mirror. The list of mirrors is at https://ctan.org/mirrors/.

Contents

Installed Programs: Over 300 binaries and symlinks to scripts
Installed Libraries: None
Installed Directories: /opt/texlive

Short Descriptions

TeX programs

The programs included in TeX are too numerous to individually list. Please refer to the individual program HTML and PDF pages in the various html, man, or pdf files within the subdirectories of 2024/texmf-dist/. Using texdoc pdflatex ( replace pdflatex with the command name ) may also be useful