Installation

Quarto CLI

Installing the Quarto CLI (command-line interface) provides you with everything you need to render basic markdown documents (including a recent version of Pandoc).

_

Verifying the Installation

You can verify that Quarto has been installed correctly with:

quarto check install

If you need to install a version more recent than the latest release, see the documentation on installing the Development Version.

Computational Tools

If you are creating computational documents with Quarto, you’ll want to be sure to install the additional dependencies required to work with Knitr and/or Jupyter.

Jupyter

If you already have Python 3 and Jupyter installed in your environment, then you should have everything required to render Jupyter notebooks with Python kernels.

If you don’t yet have Python 3 on your system, we recommend you install a version using the standard installer from https://www.python.org/downloads/.

If you are in a fresh Python 3 environment, installing the jupyter package will provide everything required to run Quarto:

Pkg. Manager Command
Pip
(Windows)
py -m pip install jupyter
Pip
(Mac/Linux)
python3 -m pip install jupyter
Conda
conda install jupyter

You can verify that Quarto is configured correctly for Jupyter with:

quarto check jupyter

Python Versions

On Mac OS and Linux, Quarto will use the version of Python 3 that it finds in the system path. Modify the PATH before invoking Quarto to use a different version of Python.

Mac OS Python 3

If you are running Mac OS you might already have a version of Python 3 installed via the Command Line Tools. Even so, we still recommend that you install a version of Python 3 using the standard installer at https://www.python.org/downloads/.

On Windows, Quarto will use Conda if it’s invoked within an activated Conda environment. Otherwise, it will use the Python Windows Launcher to select a version of Python 3. Use the PY_PYTHON environment variable to override the default behavior (for example: PY_PYTHON=3.8).

The quarto check jupyter command will tell you which version of Python will be selected for the shell it is invoked from within.

Knitr

To use Quarto with R, you should install the quarto R package:

install.packages("quarto")

Installation of the quarto package will also install the knitr package so you will have everything required to render documents containing R code. You can verify that Quarto is configured correctly for Knitr with:

quarto check knitr

Environments

if you are using Quarto Projects and want to create a project-local virtual environment for your Python and/or R dependencies see the documentation below on using Virtual Environments.

Additional Tools

Pandoc

A recent version of Pandoc (v2.14) is installed alongside Quarto. This version of Pandoc won’t interfere with others you may have on your system (it’s not added to the system PATH).

To interact directly with the version of Pandoc installed with Quarto, use the quarto pandoc command. For example:

quarto pandoc --version
quarto pandoc --list-output-formats

TeX

If you expect to use Quarto to create PDFs, you will need to install a recent distribution of TeX. While you can employ whatever toolchain you like for LaTeX compilation, we strongly recommend the use of TinyTeX, which is a distribution of TeX Live that provides a reasonably sized initial download (~100 MB) that includes the 200 or so most commonly used TeX packages for Pandoc documents.

To install TinyTeX, use the following command:

quarto tools install tinytex

If you prefer TeX Live, you can find instructions for installing it here: https://tug.org/texlive/.

Development Version

To install the development version of the Quarto CLI, clone the quarto-cli repository then run the configure script for your platform (configure-linux.sh, configure-macos.sh, or configure-windows.cmd). For example:

git clone https://github.com/quarto-dev/quarto-cli
cd quarto-cli
./configure-macos.sh

To update to the latest development version, just git pull from the local repo directory:

cd quarto-cli
git pull