# [macOS] Install BasicTeX

Instructions on how to install the BasicTeX TeX distribution on macOS.

## Uninstall

First step should be to unsinstall any previous BasicTeX installation. This
step can be skipped if no BasicTeX version was previously installed.

To uninstall any previous BasicTeX installations use the following command(s):

```sh
sudo rm -rf /usr/local/texlive /Library/TeX
```

## Install

The BasicTeX TeX distribution can be obtained
[here](https://www.tug.org/mactex/morepackages.html). Copy the link for the
package version that you want to install from there.

Get the BasicTeX installer package using the following commands:

```sh
mkdir ~/Downloads/BasicTeX
curl --silent --location --retry 3 "https://mirror.ctan.org/systems/mac/mactex/BasicTeX.pkg" --output ~/Downloads/BasicTeX/BasicTeX.pkg
```

Run the installer package using the following command:

```sh
sudo installer -pkg ~/Downloads/BasicTeX/BasicTeX.pkg -target /
```

## Verify

Open a new terminal window and check if the CMake tool is installed:

```sh
tex --version
```

## Clean up

After installing the BasicTeX TeX distribution you can remove the downloaded
installation package using the following command:

```sh
rm -rf ~/Downloads/BasicTeX
```

## Test

To test the installed tools create a file called `hello-world.tex` with the
following text:

```tex
% The LaTeX is in here!
\documentclass{article}
\begin{document}
Hello World
\end{document}
```

Then run the following command to create the pdf version:

```sh
pdflatex hellow-world.tex
```

To see the created pdf use the following command:

```sh
open hellow-world.pdf
```

## Install packages

TeX packages can be installed using the following command:

```sh
tlmgr install <package-name>
```