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#
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 thequarto
command available to users. Some use cases in Posit's professional products may require multiple versions of Quarto.
Install Quarto using .deb
file:
-
Installing Quarto from a
.deb
file places thequarto
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:
- You need to add a symlink to an installed
version if you wish to have Quarto available on the
command line as
quarto
. - If you don't need to support multiple versions, you can also install Quarto
from a
.deb
file.
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:
$ export QUARTO_VERSION="1.2.262"
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) Add symlink for Quarto#
Applicable to Workbench, only. Not required for 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 systemPATH
variable. -
If you need the
quarto
command to be available to your users — for instance, if you are installing Quarto on Workbench — you need to create a symbolic link from a location on the systemPATH
to an installed Quarto executable:Terminal$ sudo ln -s /opt/quarto/${QUARTO_VERSION}/bin/quarto /usr/local/bin/quarto
(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 will 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.
For example, if you installed Quarto 1.0.38
, 1.1.251
, and 1.2.262
to a Connect server, then you may configure Connect with all three versions of Quarto by providing multiple Executable
options to the Quarto
section of Connect's configuration file.
[Quarto]
Enabled = true
Executable = "/opt/quarto/1.0.38/bin/quarto"
Executable = "/opt/quarto/1.1.251/bin/quarto"
Executable = "/opt/quarto/1.2.262/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:
$ export QUARTO_VERSION="1.2.262"
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
A link to the latest Quarto version is maintained on the Quarto website.
$ sudo curl -LO https://quarto.org/download/latest/quarto-linux-amd64.deb
Install:
Install Quarto by running (you may 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