Install Quarto

How to install Quarto on a Linux server.


These instructions describe how to install Quarto on a Linux server. Find all available Quarto versions on the Quarto downloads page.

What is Quarto?

Quarto is an open-source scientific and technical publishing system built on Pandoc, and allows users to create dynamic content with Python, R, Julia, and Observable. Additional information about Quarto is available at https://quarto.org/.

Use bundled Quarto

Posit Workbench in RStudio Pro 2022.07.1+554 and later bundles a Quarto executable in the following directory:

/usr/lib/rstudio-server/bin/quarto/bin/quarto

RStudio users have Quarto available by default for the RStudio UI, at the R console, and in the integrated terminal. The following installation instructions are only necessary to:

Installation methods

Posit recommends two methods of installing Quarto (select one of the following links to navigate to the corresponding section, or read on for the differences between the methods):

Install Quarto using .tar.gz file:

  • To install multiple versions simultaneously, you must install Quarto using .tar.gz files. This installs Quarto to a non-standard location, so you must create a symbolic link to make the quarto command available to users. Some use cases in Posit’s professional products require multiple versions of Quarto.

Install Quarto using .deb file:

  • Installing Quarto from a .deb file places the quarto binary at the default location. This method only supports installing a single version to the default location. You can specify a version, or install the latest version.
Important

This installation method only works on Ubuntu and other Debian-based Linux distributions. For other Linux environments, you should install Quarto from .tar.gz.

Quarto .tar.gz file install

These instructions install Quarto from release archives (i.e., .tar.gz files), which lets you install it to a custom location. This makes it possible to install multiple versions concurrently. However:

Specify Quarto version

Review the list of available Quarto versions on the release page.

Now, set the QUARTO_VERSION environment variable to the version number you wish to install:

export QUARTO_VERSION="1.4.551"

Download and install Quarto using .tar.gz file

Download and install the version of Quarto specified in QUARTO_VERSION:

sudo mkdir -p /opt/quarto/${QUARTO_VERSION}

sudo curl -o quarto.tar.gz -L \
    "https://github.com/quarto-dev/quarto-cli/releases/download/v${QUARTO_VERSION}/quarto-${QUARTO_VERSION}-linux-amd64.tar.gz"

sudo tar -zxvf quarto.tar.gz \
    -C "/opt/quarto/${QUARTO_VERSION}" \
    --strip-components=1
    
sudo rm quarto.tar.gz
Important

To install Quarto on RHEL 7 or CentOS 7 platforms, you need to modify the file ending in the URL to linux-rhel7-amd64.tar.gz instead of linux-amd64.tar.gz.

A full URL example below:

"https://github.com/quarto-dev/quarto-cli/releases/download/v${QUARTO_VERSION}/quarto-${QUARTO_VERSION}-linux-rhel7-amd64.tar.gz"

Verify Quarto installation

Verify that your Quarto installation was successful:

/opt/quarto/"${QUARTO_VERSION}"/bin/quarto check

(Optional) Make Quarto available for Python editors

In Workbench, RStudio Pro sessions have Quarto available by default. To use Quarto in VSCode or JupyterLab, you need to either symlink or install Quarto into a location on the PATH for those editors.

# If using the default Quarto bundled with RStudio Pro
sudo ln -s /usr/lib/rstudio-server/bin/quarto/bin/quarto /usr/local/bin/quarto

# If you have installed a non-default Quarto 
# from a .tar.gz using the above instructions
sudo ln -s /opt/quarto/${QUARTO_VERSION}/bin/quarto /usr/local/bin/quarto

(Optional) Install multiple versions of Quarto

To install multiple versions of Quarto on the same server, repeat the steps above, setting QUARTO_VERSION to a different version number each time.

This:

  • Places different versions of Quarto in parallel folders.
  • Allows you to support multiple Quarto versions in some of Posit’s professional products.

Connect example

To configure Connect with multiple versions of Quarto, provide multiple Executable options to the Quarto section of Connect’s configuration file.

For example, if you installed Quarto1.1.189, 1.2.475, and 1.3.450 to a Connect server, then configure Connect with all three versions of Quarto by:

File: /etc/rstudio-connect/rstudio-connect.gcfg
[Quarto]
Enabled = true
Executable = "/opt/quarto/1.1.189/bin/quarto"
Executable = "/opt/quarto/1.2.475/bin/quarto"
Executable = "/opt/quarto/1.3.450/bin/quarto"

Quarto .deb file install

In an environment where you intend to only maintain a single installation of Quarto, you can install Quarto from a .deb file. This places the quarto binary at the default location, /usr/local/bin/quarto, which automatically makes the quarto command available on the default PATH.

Important

This installation method only works on Ubuntu and other Debian-based Linux distributions. For other Linux environments, you should install Quarto from .tar.gz.

Download and install Quarto using .deb file

Optionally, download a specific Quarto version, or download the latest version.

Download:

Review the list of available Quarto versions on the release page.

Now, set the QUARTO_VERSION environment variable to the version number you wish to install:

export QUARTO_VERSION="1.4.551"

Then, download the .deb file for the specified version:

sudo curl -o quarto-linux-amd64.deb -L https://github.com/quarto-dev/quarto-cli/releases/download/v${QUARTO_VERSION}/quarto-${QUARTO_VERSION}-linux-amd64.deb

The Quarto website provides a link for the latest Quarto version:

sudo curl -LO https://quarto.org/download/latest/quarto-linux-amd64.deb

:::


Install:

Install Quarto by running (you could need to install gdebi first):

sudo apt-get install gdebi-core
sudo gdebi quarto-linux-amd64.deb

Verify Quarto installation

Verify that your Quarto installation was successful:

/usr/local/bin/quarto check

Configuring Quarto with Connect

Installing Quarto on your system before configuring Connect to allow support for Quarto content is required. Complete the installation procedures above and then review the following sections of the Posit Connect Admin Guide:

Back to top