There are several options for installing Tectonic. The best choice depends onyour computing environment.

• Pre-built binary packages
  • Currently available for Arch Linux, nixpkgs, nixOS and MacPorts/Homebrew on macOS/OS X
• The cargo install method
  • Easiest if you already have C++ and Rust development tools installed
• The Anaconda method
  • Reliable and cross-platform

If unsure, try the Anaconda method. It involves a fewsteps in the command line and a few downloads, but it is straightforward andreliable.

We’re actively working to provideadditional methods to install Tectonic! If there’s a new method that you wouldlike to see or can help provide, please mention it on the forums.

If any of these instructions don’twork for you or can be clarified, please filean issue on this website’s GitHub issue tracker.

The latest release of Tectonic now supports Windows! If you can help withproviding binary packages to ease installation on this platform, pleaseget in touch.

For building your own Windows binary, see here.

• To install LaTeX, on Windows use MiKTeX; on OSX use MacTex, and on Linux use your distro’s package manager. Dvipng must also be installed. For example, on Mac you can run brew cask install mactex and that should be all you need to get it working with Anki.
• There are several options for installing Tectonic. The best choice depends on your computing environment. Pre-built binary packages. Currently available for Arch Linux, nixpkgs, nixOS and MacPorts/Homebrew on macOS/OS X The cargo install method. Easiest if you already have C and Rust development tools installed.

Brew install pandoc. Homebrew can also install other software that integrates with Pandoc. For example, to install librsvg (its rsvg-convert covers formats without SVG support), Python (to use Pandoc filters), and BasicTeX (to typeset PDFs with LaTeX): brew install librsvg python homebrew/cask/basictex.

These are specific to your operating system. We only provide a few right now.

Arch Linux:

There is a tectonic package in theAUR.FollowThe instructions on the Arch Wikito download and install it.

First, make sure you have theprerequisitesinstalled.Download the build files using

It is good practice to carefully check the PKGBUILDand any .install files for malicious commands.Then install the package and any dependenciesby running makepkg in the package directory

nix or nixOS

You can imperatively install tectonic by calling nix-env -iA nixos.tectonic in your shell.You can also create a temporary environment using nix-shell:

You should be dropped into a shell and now be able to use tectonic successfully.

Void Linux:

Void Linux has a tectonic package in the void-packages repository. To install it, just run

MacPorts on macOS/OS X

There is a tectonic port in MacPorts. If youalready have MacPorts installed, installing Tectonic should be as simple as:

Homebrew on macOS/OS X

There is a tectonic package in Homebrew. If you alreadyhave Homebrew installed, installing Tectonic should be as simple as:

If your system has C++ and Rust compilers installed, you can install Tectonicusing Rust’s packaging tool, cargo.Make sure that Rust’s bin folder ($HOME/.cargo/bin by default) is inyour $PATH.Tectonic currently requires various system support libraries to be installed,so you must do some setup before attempting the installation. The varioussteps are broken out by operating system below.

Debian and Ubuntu Linux:

Ensure that the requisite packages are installed with the following command:

Once that is done, the following should be sufficient to download and installthe latest Tectonic release:

You can then run Tectonic with:

RHEL, CentOS, or Fedora Linux:

Ensure that the requisite packages are installed with the following command:

Once that is done, the following should be sufficient to download and installthe latest Tectonic release:

You can then run Tectonic with:

macOS / OS X with Homebrew:

The recommended way to install the required dependencies is withHomebrew. The following commands will install the requiredformulae:

If you’re not using rustup you should also

The cargo invocation is then as normal, but requires some auxiliaryenvironment variables as well:

Alternatively, you can build tectonic from source by running

You can then run Tectonic with:

If the other installation methods do not or cannot work for you, anotherreliable installation method is based onContinuum Analytics’ Anaconda Python framework,even though nothing in Tectonic uses Python.

This method works for Linux and macOS computers.

If you already have Anaconda Python installed:

The support libraries that we use are only provided throughconda-forge, a community-led project thatemulates and updates the official Anaconda system. To use Tectonic you muststart using conda-forge packages. The packages from conda-forge will replacenearly all of the ones from a stock Anaconda installation, but that’s OK. Thereplacement packages aim to be drop-in replacements for the standarddistribution.

If you are already using conda-forge, you don’t need to change anything.Otherwise, run this command to enable conda-forge in your installation:

To complete the installation, run these commands:

If you need to install both Tectonic and Anaconda Python:

We recommend that you use Continuum’s “Miniconda” installer to get set upquickly. First, install Minicondaaccording to these official instructions.

Brew Latexdraw

Once Miniconda is installed you may need to open a new terminal in order forits changes to take effect. If all went well, the command conda will now beavailable in your terminal. Proceed using the instructions given in theprevious section.