logonavy




Downloading MacTeX 2025

MacTeX-2025 requires macOS 10.14 or higher. These systems are named Mojave, Catalina, Big Sur, Monterey, Ventura, Sonoma, and Sequoia. It runs natively on both Arm and Intel machines. The same source code is used to compile both types of code, so Apple's Arm and Intel machines are on exactly the same footing. All install packages are developer-signed and notarized by Apple.

One program, asymptote, does not run on Mojave but runs on Catalina and higher. This program is a recent addition to TeX Live and was seldom used on Mojave.

Click the link below to download. While downloading, please skim the rest of the page. Users who run into trouble sometimes write us without noticing that the solution is on this very page.

MacTeX.pkg.

The Size is 6.0G - 08 March 2025

The MD5 sum is 9c0adf674d1a97d1925bc9acad39b10b

The SHA512 sum is 93a853296afdec6eb2b30d9efeef028c87e607179bcdea19804e09e6c38e391d533620f84545293b4e448ca0dcaebccc62a11e0093bf2340f0906b02415017b5



Installing MacTeX

It is not necessary to remove earlier TeX distributions before installing MacTeX, because the distribution will be installed in a separate location /usr/local/texlive/2025.

After downloading, move the file MacTeX.pkg to the desktop or another convenient spot, and double click it to install. Follow the straightforward instructions. Installation on a recent Macintosh takes about ten minutes. The installer presents a Welcome page, a ReadMe page, a Software License page, and a Final Page. Clicking the "Install" button on this Final page will start the actual installation. The final page also has a ''Customize" button, which leads to a panel allowing users to decide which pieces to install: Ghostscript, Ghostscript-Extras , GUI Applications, and TeX Live itself. Most users will use the standard installation and ignore "Customize". Users who use MacPorts or HomeBrew may prefer to use the Ghostscript provided by these projects and should use "Customize" to disable Ghostscript installation. Near the end of installation, there will be a a pause when nothing seems to happen. During this pause, TeX Live creates format files for the typesetting engines.

At the end of installation, the installer will report "Success." But sometimes, the installer puts up a dialog saying "Verifying..." and then the install hangs. In all cases known to us, rebooting the Macintosh fixes this problem. After the reboot, install again.

When installation is complete, go to /Applications/TeX and read the document READ ME FIRST installed there, which explains how to find and use LaTeX. A copy of this document is available here. If other problems are reported during installation, skip to the section "Installation Errors" below.

Miscellaneous Details

MacTeX writes a symbolic link /Library/TeX/texbin which indirectly points to the TeX Live binary directory. Configure your GUI programs to use this link. The GUI programs we supply will automatically configure themselves.

MacTeX installs TeX Live, the actual TeX distribution, in /usr/local/texlive/2025. This location is often hidden in the Finder. Typical users access TeX using a "front end", a program providing an editor to enter TeX source and a preview window to view the typeset output. MacTeX installs the front end TeXShop in /Applications/TeX and most people will access TeX using that front end or a similar one.

MacTeX does not overwrite the TeX distribution from the previous year. Users who run into trouble can switch to the previous distribution until the new distribution is fixed. To switch, use TeX Live Utility which is in /Applications/TeX. Select the Configure menu item "Change Default TeX Live Version."

MacTeX completely configures TeX, so after installation it is ready to use. Go to "/Applications/TeX/READ ME FIRST.pdf" and read this short document to get started.

What Is Installed

MacTeX installs TeX Live, which contains TeX, LaTeX, AMS-TeX, and virtually every TeX-related style file and font. TeX Live is maintained by TeX User Groups across the world. TeX Live is compiled from the same sources for all platforms: Macintosh, Windows, Linux, Unix.

MacTeX also installs the GUI programs TeXShop, LaTeXiT, TeX Live Utility, and BibDesk.

MacTeX installs Ghostscript, an open source version of Postscript. An optional package, Ghostscript-Extras, installs libgs, the dynamical library for Ghostscript, and mutool, an extra tool. The programs in Ghostscript-Extras are used by only one program in TeX Live, dvisvgm. So they are not installed by default, but can be obtained using the "custom install" option in MacTeX.

X11 is an open source windowing system used by Linux systems. Most Macintosh users can ignore it. An open source version of X11 called XQuartz is available for the Macintosh. It can be found here. If you use X11, you should update to the latest version of XQuartz, 2.8.5. The TeX Live programs xdvi, pdfopen, and pdfclose require X11. Ghostscript comes with two binaries, gs-X11 and gs-noX11, where gs-X11 has support for X11 and gs-noX11 does not. When Ghostscript is first installed, a symbolic link named gs is created in /usr/local/bin. If X11 is present, gs points to gs-X11; otherwise it points to gs-noX11.

Installation Errors

Sometimes at the end of installation, the installer will report "The Installer encountered an error that caused the installation to fail. Contact the software manufacturer for assistance." In almost all cases, this error is caused by a faulty download. There is an easy way to check this. Go to /Applications/Utilities and run Terminal. Type
md5
and a space. Then drag the install package icon "MacTeX.pkg" and drop it on the Terminal window. Push RETURN. Terminal will print a message and then a long item with letters and numbers. Compare this number to the MD5 sum at the top of this page just under the MacTeX.pkg link. If the two numbers are different, your download was defective and you must download again. Third party browsers can be used to download, and work well. If such a browser consistently gives an error, we recommend trying Safari for the new download.

If you are having trouble downloading MacTeX, note that the download link points to a "multiplexer" site which parcels out requests to various up-to-date CTAN mirrors. Occasionally users have trouble getting the package from this multiplexer. In that case, choose a specific mirror on this mirror page.

MacTeX is a very large package. If your network is noisy, you might want to try downloading and installing BasicTeX. See Smaller Download. BasicTeX is very much smaller, and yet has most files, fonts, and programs to process TeX, so this is a rapid way to get a working TeX. BasicTeX need not be uninstalled before installing MacTeX, so once you convince yourself that our packages work, you can return to the main task of installing MacTeX. TUG strongly recommends the full MacTeX for most users, including beginners,

Installation Error: 10 Minute Limit

During pretesting of MacTeX-2025, a new installation error was reported. The package was revised to eliminate this error, but it might recur in unusual circumstances. It is easily fixed.

The installer first writes a large number of packages to /usr/local/texlive/2025. Then it runs a postinstall script which configures the distribution. The installer reports the moment when the script first starts running. If the script run takes longer than ten minutes, Apple aborts the installation and reports an error.

The installer's "Window" menu offers to show a Log of the installation. If your computer is slow, it is not a good idea to show this window during installation, because writing the items takes up part of those allotted ten minutes. But after installation ends, the Log window can be opened. The 10-minute error would be reported in a line near the end of the log file, which reads

   Terminating PKInstall Task. Task has exceeded its 600 seconds of runtime.

By the time this error occurs, the installation has been completely set up and some final scripts are running. You can finish these final tasks yourself. Find the "Terminal" program in /Applications/Utilities and run it. Enter each line below in Terminal, pushing RETURN after the line is complete. Since Unix is picky about syntax, it is easiest to copy the lines from the display below. When you are done, MacTeX-2025 is fully configured and ready to use.

   sudo /usr/local/texlive/2025/bin/universal-darwin/mktexlsr
   sudo /usr/local/texlive/2025/bin/universal-darwin/updmap-sys
   sudo /usr/local/texlive/2025/bin/universal-darwin/fmtutil-sys --missing
   sudo /usr/local/texlive/2025/bin/universal-darwin/mktexlsr 
 

In one known case, a machine was so slow that even the setup material was not finished after ten minutes, so the above solution failed. Users who run into that case should download and run postinstall2025.sh.

Updating Various Pieces after Installation

TeX Live 2025 and the various GUI programs installed by MacTeX are up to date as of March, 2025. But various pieces may have been updated since then. Each of our GUI programs has a menu item called "Check for Updates." Select this item to update the program to the current version. The TeX Live command line files are updated daily. To install these updates, use TeX Live Utility in /Applications/TeX.




Happy TeXing on macOS !

Donate