Das Erste, was die meisten nach der Installation von LaTeX eintippen, ist pdflatex --version. Zurück kommt nicht „pdfLaTeX“, sondern pdfTeX 3.141592653-2.6-1.40.26 (TeX Live 2024). Dass die Versionsnummer π ist, ist kein Scherz – Knuth legte fest, dass TeX’ Version gegen π konvergieren soll – und pdflatex meldet sich als pdfTeX, weil pdflatex buchstäblich ein symbolischer Link auf pdftex ist. Diese Seite führt die Installation unter Windows, macOS und Linux durch, prüft, was tatsächlich angekommen ist, und widmet sich dann ausführlich dem Fehler, den alle treffen: Der Befehl liegt nicht im PATH. Die aktuellen Ausgaben sind TeX Live 2026 (1. März 2026) und MacTeX-2026.
Zwei Entscheidungen vor dem Start des Installationsprogramms
Es sind nur zwei: wie viel installiert wird (das Schema) und wohin. Alles Übrige fragt das Installationsprogramm ab. Das voreingestellte scheme-full liegt bei rund 8 GB, das mittlere scheme-medium bei knapp 2 GB, das kleine scheme-basic bei gut 200 MB. Über eine schmale Leitung dauern Herunterladen und Entpacken einer Vollinstallation leicht über eine Stunde. Welches Schema was enthält – und ob überhaupt TeX Live oder MiKTeX – vergleicht die Seite „Distributionen“; hier geht es um die Arbeit nach der Entscheidung.
LaTeX unter Windows installieren
Windows ist von den drei Plattformen die unkomplizierteste. Für TeX Live genügt es, install-tl-windows.exe von tug.org zu laden (rund 20 MB; das inhaltsgleiche install-tl.zip tut es auch) und auszuführen. Es handelt sich um einen Netzinstaller: Nach dem Start holt er die Distribution während der Installation von einem CTAN-Spiegel. Vorgabeziel ist C:\texlive\2026, das Schema wird in der grafischen Oberfläche gewählt. Entscheidend ist: Unter Windows setzt das Installationsprogramm PATH selbst – der neue Eintrag kommt nach vorn, wenn bereits ein anderes TeX vorhanden ist, sonst ans Ende. Danach eine neue Eingabeaufforderung öffnen: Ein bereits geöffnetes Fenster hält noch den alten PATH.
REM Verify in a NEW Command Prompt after the installer finishes
where pdflatex
pdflatex --version
tlmgr --versionWer MiKTeX wählt, holt den Basic MiKTeX Installer (.exe) von der Download-Seite auf miktex.org und führt ihn aus. Der Assistent fragt im Wesentlichen drei Dinge: nur aktueller Benutzer (empfohlen) oder für alle Benutzer, das Papierformat und ob fehlende Pakete automatisch installiert werden (Always / Ask me first / Never). Eine gemeinsame Installation verlangt Administratorrechte, und da spontan geholte Pakete ohnehin im Baum des jeweiligen Benutzers landen, ist „nur aktueller Benutzer“ auf einem persönlichen Rechner die ehrliche Wahl. Danach die MiKTeX Console starten und zuerst nach Updates sehen. Für die unbeaufsichtigte Ausbringung auf viele Rechner steht eine stille Installation über miktexsetup bereit.
LaTeX unter macOS installieren (MacTeX)
Der Standard unter macOS ist MacTeX. MacTeX.pkg (rund 6,4 GB) von tug.org laden, doppelklicken, den Anweisungen folgen – da es von Apple signiert und notariell beglaubigt ist, hält Gatekeeper es nicht auf. TeX selbst landet in /usr/local/texlive/2026, die grafischen Programme (TeXShop, BibDesk, LaTeXiT, TeX Live Utility) in /Applications/TeX/. MacTeX-2026 verlangt macOS 11 (Big Sur) oder neuer und läuft nativ auf Intel wie auf Apple Silicon; Catalina und älter werden nicht mehr unterstützt.
Beim PATH ist macOS das durchdachteste der drei Systeme. Statt das Binärverzeichnis (/usr/local/texlive/2026/bin/universal-darwin) direkt in den PATH zu legen, richtet MacTeX einen festen symbolischen Link, /Library/TeX/texbin, auf die Programme der aktiven Ausgabe. Auf diesem Mac verfolgt, lautet die Kette /Library/TeX/texbin → Distributions/Programs/texbin → bin des aktuellen Jahrgangs; eine Datei in /etc/paths.d fügt /Library/TeX/texbin dem Standard-PATH hinzu. Ergebnis: Ein frisch geöffnetes Terminal funktioniert einfach, und der Jahrgangswechsel verlangt keine Änderung an einer Konfigurationsdatei. Um es sofort in einer bereits offenen Shell zu nutzen, wird PATH mit path_helper neu aufgebaut.
# Refresh PATH in the current shell, then verify
eval "$(/usr/libexec/path_helper)"
which pdflatex # -> /Library/TeX/texbin/pdflatex
pdflatex --versionWer die grafischen Programme nicht braucht und mit der Kommandozeile auskommt, fährt mit Homebrew schneller. mactex enthält die grafischen Programme, mactex-no-gui ist dasselbe vollständige TeX Live ohne sie, und basictex ist ein deutlich kleinerer Minimalbau (ohne grafische Programme, ohne Ghostscript), der nach /usr/local/texlive/2026basic installiert. Da ohnehin die meisten in VS Code oder Ähnlichem schreiben, fällt die Wahl in der Praxis meist auf mactex-no-gui.
# Full TeX Live without the GUI apps (the usual Homebrew choice)
brew install --cask mactex-no-gui
# Or the full bundle with GUI apps
# brew install --cask mactex
# Or a small starter install
# brew install --cask basictexInstallation unter Linux / Unix
Unter Linux/Unix ist der geradlinige Weg das offizielle Installationsprogramm install-tl. install-tl-unx.tar.gz holen, entpacken, das mitgelieferte Perl-Skript ausführen. Vorgabeziel ist /usr/local/texlive/2026; dorthin zu schreiben verlangt sudo – oder, falls sudo gar nicht in Frage kommt, im interaktiven Menü D (directories) drücken und das Ziel unter das eigene Heimatverzeichnis legen, etwa ~/texlive/2026, womit sich das Rechteproblem erledigt. Lieber ein grafisches Installationsprogramm als die Textoberfläche? perl ./install-tl -gui startet die Tcl/Tk-Fassung, und --no-interaction installiert die Vorgabekonfiguration ohne Rückfragen.
# Download, unpack and run the official net installer
cd /tmp
curl -LO https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz
zcat < install-tl-unx.tar.gz | tar xf -
cd install-tl-*
sudo perl ./install-tl # interactive text installer
# sudo perl ./install-tl -gui # Tcl/Tk installer instead
# sudo perl ./install-tl --scheme scheme-medium --no-interactionUnter Unix wird PATH selbst gesetzt; anders als bei Windows gibt es keinen automatischen Schritt. Das Binärverzeichnis trägt den Namen des CPU: /usr/local/texlive/2026/bin/x86_64-linux auf 64-Bit-Intel/AMD, unter macOS wie auf diesem Rechner universal-darwin. Den Namen muss man sich nicht merken – das Installationsprogramm druckt kurz vor dem Ende genau die Zeilen aus, die hinzuzufügen sind. Neben PATH liefert es auch die Pfade für man- und info-Seiten; alle drei Zeilen kommen in die Startdatei der Shell (~/.zshrc bei zsh, ~/.profile oder ~/.bashrc bei der Bash-Familie).
# Add to ~/.profile or ~/.bashrc; the folder name follows your CPU
export PATH="/usr/local/texlive/2026/bin/x86_64-linux:$PATH"
export MANPATH="/usr/local/texlive/2026/texmf-dist/doc/man:$MANPATH"
export INFOPATH="/usr/local/texlive/2026/texmf-dist/doc/info:$INFOPATH"
# Then reload and check
. ~/.profile
which pdflatexWenn die Installation über das Netz unrealistisch ist – schmale Leitung, Dutzende Rechner im Labor oder gar kein Internet –, lässt sich vom jährlichen ISO-Abbild installieren. Das rund 6 GB große ISO von einem CTAN-Spiegel holen, einhängen und das darin liegende install-tl ausführen (unter Windows install-tl-windows.bat); die gesamte Distribution wird ohne Netz eingerichtet. Ein Vorbehalt: Der Inhalt des ISO wird nach der Veröffentlichung nie aktualisiert – nach der Installation also daran denken, die Aktualisierungsquelle wieder auf das Online-Repository tlnet zu richten.
# Offline install from the yearly ISO image (Linux/Unix)
sudo mount -t iso9660 -o ro,loop,noauto texlive.iso /mnt
cd /mnt && sudo perl install-tl
# Afterwards, send updates back to the online repository
tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnetPrüfen, ob es angekommen ist: which pdflatex und pdflatex --version
Die Prüfung erfolgt in drei Stufen und beantwortet: welches Programm läuft, welcher Jahrgang es ist und zu welchem Baum es gehört. which pdflatex (unter Windows where pdflatex) nennt die Datei, die tatsächlich ausgeführt wird, und pdflatex --version meldet sich samt Jahrgang, etwa als pdfTeX 3.141592653-2.6-1.40.26 (TeX Live 2024). Der Ort der ausführbaren Datei genügt aber nicht. Ausschlaggebend ist kpsewhich -var-value=SELFAUTOPARENT: Es liefert die Wurzel des TeX-Baums, den dieses Programm wirklich benutzt – auf diesem Mac /usr/local/texlive/2024. Wo Programm und Baum auseinandergedriftet sind, deckt diese eine Zeile es zuerst auf.
# 1. which binary runs, 2. which release it is, 3. which tree it uses
which pdflatex
pdflatex --version
kpsewhich -var-value=SELFAUTOPARENT
# On Windows, replace the first line with:
# where pdflatexZum Schluss einmal beweisen, dass tatsächlich gesetzt werden kann: eine winzige .tex-Datei schreiben, übersetzen – erscheint ein PDF, ist die Installation fertig. Scheitert dieser Schritt, liegt es fast nie am PATH; zu prüfen ist eher, ob das Arbeitsverzeichnis beschreibbar ist oder ob im Dateinamen Zeichen außerhalb von ASCII stecken.
printf '\\documentclass{article}\\begin{document}Hello, \\LaTeX!\\end{document}' > hello.tex
pdflatex hello.tex
# -> produces hello.pdfWenn der Befehl latex fehlt oder der falsche Jahrgang läuft
Gibt which oder where gar nichts zurück, ist PATH nicht eingerichtet. Kommt etwas zurück, verhält sich aber seltsam, lohnt ein genauer Blick auf den ausgegebenen Pfad. Was als „der LaTeX-Pfad funktioniert nicht“ beschrieben wird, ist in der Praxis eines von drei Dingen. Erstens: Das Terminal wurde nie neu geöffnet – die Einstellung ist geändert, doch diese Shell hält noch den alten PATH. Zweitens: PATH zeigt weiterhin auf den Baum eines alten Jahrgangs. Im Vorjahr wurde /usr/local/texlive/2025/bin/... in ~/.zshrc eingetragen, inzwischen ist die neue Ausgabe installiert, und die Zeile steht immer noch da. Wurde /usr/local/texlive/2025 gelöscht, erscheint command not found; wurde es nicht gelöscht, läuft der Vorjahrgang klaglos weiter. Drittens: Zwei TeX-Installationen streiten darum, wer zuerst kommt.
Der dritte Fall ist der unangenehmste: pdflatex aus TeX Live, bibtex aus einem Systempaket, tlmgr aus einem alten MacTeX. Man meint, ein einziges Manuskript zu verarbeiten – die Werkzeuge schauen jedoch in verschiedene Bäume. Statt which immer wieder einzutippen, empfiehlt sich ein einziger Aufruf von tlmgr conf. Der Befehl durchsucht den PATH und listet die aufgelösten Orte von pdftex, xetex, luatex, dvips, dvipdfmx, kpsewhich, fmtutil, updmap und tlmgr auf und druckt anschließend auch die aktiven Konfigurations- und Font-Map-Dateien. Zeigt auch nur eine Zeile in einen anderen Baum als die übrigen, ist dort die Ursache.
# One command that resolves every core tool at once
tlmgr conf
# Look for a line whose path differs from the others, e.g.
# pdftex: /usr/local/texlive/2026/bin/universal-darwin/pdftex
# bibtex: /usr/bin/bibtex <- a different install!
# The manual equivalent, if tlmgr itself is the thing you distrust
which pdflatex
which lualatex
which tlmgr- Nach dem Bearbeiten einer Startdatei ein neues Terminal öffnen oder die Datei erneut einlesen. Ein offen gelassenes Terminal hat weiterhin den alten PATH.
- Vor der Installation auf einem Rechner, auf dem schon TeX liegt, die Ausgabe von
which pdflatexnotieren. Später weiß man, was sich geändert hat. - Ein Verzeichnis, das zweimal im PATH steht, schadet nicht. Schädlich ist eine Zeile, die auf einen anderen Baum zeigt und vorne steht.
- Wer das offizielle TeX Live nutzt, sollte nicht nachträglich
texlive-*ausapthinzufügen – sonst konkurrieren zwei Bäume um den Anfang des PATH. - Wer MiKTeX nutzt, hält Aktualisierungen und Paketergänzungen in der MiKTeX Console.
tlmgrverwaltet MiKTeX nicht.