Skip to content

Install 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/

These instructions describe how to install Quarto on a Linux server.

Installation methods#

RStudio 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 RStudio's professional products may 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 easily 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: https://github.com/quarto-dev/quarto-cli/releases/.

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

Terminal
$ export QUARTO_VERSION="0.9.522"

Download and install Quarto using .tar.gz file#

Download and install the version of Quarto specified in QUARTO_VERSION:

Terminal
$ 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

Verify Quarto installation#

Verify that your Quarto installation was successful:

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

Applicable to RStudio Workbench, only. Not required for RStudio Connect.

Important

This section only applies to the first installation of Quarto on a given system. For subsequent installations, skip this section.

  • Installing Quarto from the .tar.gz file using these instructions places the executable in a location that is not on the default system PATH variable.
  • If you need the quarto command to be available to your users — for instance, if you are installing Quarto on RStudio Workbench — you need to create a symbolic link from a location on the system PATH to an installed Quarto executable:

    Terminal
    $ 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 RStudio's professional products.

For example, if you installed Quarto 1.0.0, 0.9.498, and 0.9.344 to an RStudio Connect server, then you could configure RStudio Connect with all three versions of Quarto by providing multiple Executable options to the Quarto section of RStudio Connect's configuration file.

File: /etc/rstudio-connect/rstudio-connect.gcfg
[Quarto]
Enabled = true
Executable = "/opt/quarto/1.0.0/bin/quarto"
Executable = "/opt/quarto/0.9.498/bin/quarto"
Executable = "/opt/quarto/0.9.344/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: https://github.com/quarto-dev/quarto-cli/releases/.

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

Terminal
$ export QUARTO_VERSION="0.9.522"

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

Terminal
$ 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

A link to the latest Quarto version is maintained on the Quarto website.

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

Install:

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

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

Verify Quarto installation#

Verify that your Quarto installation was successful:

Terminal
$ /usr/local/bin/quarto check
Back to top