Skip to content

Install Posit Connect#

RStudio is now Posit!

Our professional products have been renamed to Posit Connect, Posit Workbench, Posit Package Manager, Posit Cloud, and Posit Academy so it’s easier for folks to understand that we support more than just R. Please review our Blog post/FAQ to answer commonly asked questions about the rebrand.

These instructions describe how to install Posit Connect, formerly RStudio Connect, on a Linux server. See Install Posit Professional Products for alternative installation instructions.

Posit highly recommends installing and initially configuring Connect with the Setup Assistant, formerly the Setup Tool, referencing the steps below. The Setup Assistant provides a user-friendly UI to install, initially configure, test, and deploy Connect.

Install using .rpm or .deb files

Connect can be installed manually by using .rpm or .deb files. Although this manual installation method is available, it is only needed for rare use cases, and the Setup Assistant installation is preferred for most users. Please see the Manual Installation documentation for more information.

Prerequisites

This installation method uses the Setup Assistant to install Connect. The Setup Assistant is currently only available for first-time installations and cannot be used for making updates to your configuration.

If you are upgrading from an older version to a newer one, please refer to our Upgrade guide.

Before proceeding with the installation, you must:

  • Meet the Requirements for Connect
  • Review the Setup Assistant information checklist and verify that you have the required information:

    Setup Assistant information checklist

    The following information will need to be provided in the Setup Assistant:

    • A license key (unless running an evaluation)
    • Version(s) of R users will need on the the sever
    • Version(s) of Python users will need on the server
    • Authentication integration details
    • Git credentials (optional)
    • The public server or hostname of the Connect server
    • SSL/TLS certificates (recommended)
      • Public certificate file
      • Private key file
    • SMTP mail server integration details
      • The hostname or IP address of the SMTP server used for email delivery
      • Email address used by Connect to send outbound email
    • PostgreSQL database details (if you plan on configuring load balancing)

Step 1: Download and run the installation script#

The installation script works across all supported Linux distributions, validates the GPG key of the downloaded package, and includes support for offline use.

Note

The installation script must be run by a privileged user or a user with sudo privileges.

To install Connect, download and run the installation script:

$ curl -Lo rsc-installer.sh https://cdn.rstudio.com/connect/installer/installer-v6.0.0.sh
$ sudo -E bash ./rsc-installer.sh 2022.11.0

The script:

  1. Downloads missing required dependencies
  2. Downloads the Connect package
  3. Installs Connect

After the installation is complete, you will be given the choice to:

Troubleshooting Information

If you are not able to successfully install Connect using the installation script, then please review and complete the troubleshooting steps provided in the installation script's output. If you still require additional help, please refer to the troubleshooting article published by Support.

Connect Install Files#

  • If you don't have an .rpm or .deb file containing Connect and all of its dependencies (other than R), use one of the following to download and install Connect:

    Connect Install files

    If you don't have an .rpm or .deb file containing Connect and all of its dependencies (other than R), use one of the following to download and install Connect:

    $ curl -O https://cdn.rstudio.com/connect/2022.11/rstudio-connect-2022.11.0.el8.x86_64.rpm
    $ sudo yum install rstudio-connect-2022.11.0.el8.x86_64.rpm
    
    $ curl -O https://cdn.rstudio.com/connect/2022.11/rstudio-connect-2022.11.0.el7.x86_64.rpm
    $ sudo yum install rstudio-connect-2022.11.0.el7.x86_64.rpm
    
    $ curl -O https://cdn.rstudio.com/connect/2022.11/rstudio-connect-2022.11.0.amazonlinux2.x86_64.rpm
    $ sudo yum install rstudio-connect-2022.11.0.amazonlinux2.x86_64.rpm
    
    $ sudo apt-get install gdebi-core
    $ curl -O https://cdn.rstudio.com/connect/2022.11/rstudio-connect_2022.11.0~ubuntu22_amd64.deb
    $ sudo gdebi rstudio-connect_2022.11.0~ubuntu22_amd64.deb
    
    $ sudo apt-get install gdebi-core
    $ curl -O https://cdn.rstudio.com/connect/2022.11/rstudio-connect_2022.11.0~ubuntu20_amd64.deb
    $ sudo gdebi rstudio-connect_2022.11.0~ubuntu20_amd64.deb
    
    $ sudo apt-get install gdebi-core
    $ curl -O https://cdn.rstudio.com/connect/2022.11/rstudio-connect_2022.11.0~ubuntu18_amd64.deb
    $ sudo gdebi rstudio-connect_2022.11.0~ubuntu18_amd64.deb
    
    $ curl -O https://cdn.rstudio.com/connect/2022.11/rstudio-connect-2022.11.0.sles15.x86_64.rpm
    $ sudo zypper install rstudio-connect-2022.11.0.sles15.x86_64.rpm
    
    $ curl -O https://cdn.rstudio.com/connect/2022.11/rstudio-connect-2022.11.0.sles12.x86_64.rpm
    $ sudo zypper install rstudio-connect-2022.11.0.sles12.x86_64.rpm
    

Please see the Manual Installation documentation for more information.

Step 2: Configure Connect using the Setup Assistant#

The Setup Assistant is designed to step through several initial configuration options, with a primary focus on validating your licensing and authentication settings.

If you need to pause the configuration process:

  • You may close your browser.
  • Return to the configuration process later with the saved state.
Setup Assistant CLI Flags

The Setup Assistant supports the following flags:

Option Function
-h Print help
-x Launches the Setup Assistant (requires Connect installation)

To use one of the flags listed above, execute the following command:

Terminal
sudo -E bash ./rsc-installer.sh <flag>

For example, if you want to launch the Setup Assistant after manually installing Connect, run:

Terminal
sudo -E bash ./rsc-installer.sh -x

Step 3: Additional integration and validation tasks#

Upon completion, you will be redirected back to this site for a review of additional recommended integration and validation tasks. These recommended integration and validation tasks are available in the Setup Assistant - Post Installation Procedures documentation.

Note

The Setup Assistant does not currently support offline evaluations or floating license server configurations. Refer to the Supported Setup Tool Features Overview Licensing section, shown below, for more information.


The following features can be initially configured with the Setup Assistant:

Supported Setup Assistant Features Overview

Licensing

Setup Assistant Feature Support Included Recommended Instructions
Online Evaluation ✔️
Offline Evaluation ✔️
Online License Key ✔️
Offline License Key ✔️
Floating License For this option, please use the Manual Installation and reference the Floating Licenses documentation.

Authentication

Setup Assistant Feature Support Included Recommended Instructions
SAML ✔️
LDAP ✔️
PAM ✔️
OAuth (OIDC) ✔️
Password Built-in ✔️

Environments

Setup Assistant Feature Support Included Recommended Instructions
R Installations ✔️
Python Installations ✔️
Recommended System Packages ✔️

Web Server

Setup Assistant Feature Support Included Recommended Instructions
HTTPS ✔️ This is recommended.
HTTP ✔️
Proxy Server Can be configured post-setup: Instructions

Mail Server

Setup Assistant Feature Support Included Recommended Instructions
SMTP ✔️
Sendmail Not the recommended option, but if necessary, please use the Manual Installation option and reference the Email Setup documentation.
Disable Mail ✔️ Not the recommended option. Additionally, if email is disabled, then several Connect features will not function.

Databases

Setup Assistant Feature Support Included Recommended Instructions
SQLite ✔️ Additional Information
PostgreSQL ✔️ Additional Information

Additional Configuration Options

Setup Assistant Feature Support Included Recommended Instructions
Version Control ✔️
Data Sources Can be configured post-setup: Instructions
Load Balancing Can be configured post-setup: Instructions
Service, Audit, and Access Logging ✔️ Additional Information