Install RStudio Connect#

Prerequisites

This installation method uses the Setup Tool to install RStudio Connect. The Setup Tool 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 RStudio Connect
  • Review the Setup Tool information checklist and verify that you have the required information:

    Setup Tool information checklist

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

    • A license key (unless running an evaluation)
    • Version(s) of R users will need on the server
    • Version(s) of Python users will need on the server
    • Authentication integration details
    • The public server or hostname of the machine where RStudio Connect will run
    • SSL/TLS certificates (recommended)
      • Public certificate file
      • Private key file
    • SMTP mail server integration details (recommended)
      • The hostname or IP address of the SMTP server used for email delivery
      • Email address used by RStudio 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 RStudio Connect, download and run the installation script:

$ curl -Lo rsc-installer.sh https://cdn.rstudio.com/connect/installer/installer-v1.3.1.sh
$ sudo -E bash ./rsc-installer.sh 1.8.4.1-20

Info

RStudio highly recommends installing and initially configuring RStudio Connect with the Setup Tool, referencing the steps below. The Setup Tool provides a user-friendly UI to install, initially configure, test, and deploy RStudio Connect. Although there is a Manual Installation available, it is only needed for rare use cases, and the Setup Tool installation is preferred for most users.

The script:

  1. Downloads the RStudio Connect package
  2. Prompts for any missing required dependencies
  3. Installs RStudio Connect

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

RStudio Connect Install Files
  • If you want to download and install RStudio Connect using an RPM or DEB file then:

    RStudio Connect Install files

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

    $ curl -O https://cdn.rstudio.com/connect/1.8.4/rstudio-connect-1.8.4.1-20.el8.x86_64.rpm
    $ sudo yum install rstudio-connect-1.8.4.1-20.el8.x86_64.rpm
    
    $ curl -O https://cdn.rstudio.com/connect/1.8.4/rstudio-connect-1.8.4.1-20.el7.x86_64.rpm
    $ sudo yum install rstudio-connect-1.8.4.1-20.el7.x86_64.rpm
    
    $ curl -O https://cdn.rstudio.com/connect/1.8.4/rstudio-connect-1.8.4.1-20.el6.x86_64.rpm
    $ sudo yum install rstudio-connect-1.8.4.1-20.el6.x86_64.rpm
    
    $ sudo apt-get install gdebi-core
    $ curl -O https://cdn.rstudio.com/connect/1.8.4/rstudio-connect_1.8.4.1-20~ubuntu20_amd64.deb
    $ sudo gdebi rstudio-connect_1.8.4.1-20~ubuntu20_amd64.deb
    
    $ sudo apt-get install gdebi-core
    $ curl -O https://cdn.rstudio.com/connect/1.8.4/rstudio-connect_1.8.4.1-20~ubuntu18_amd64.deb
    $ sudo gdebi rstudio-connect_1.8.4.1-20~ubuntu18_amd64.deb
    
    $ sudo apt-get install gdebi-core
    $ curl -O https://cdn.rstudio.com/connect/1.8.4/rstudio-connect_1.8.4.1-20~ubuntu16_amd64.deb
    $ sudo gdebi rstudio-connect_1.8.4.1-20~ubuntu16_amd64.deb
    
    $ curl -O https://cdn.rstudio.com/connect/1.8.4/rstudio-connect-1.8.4.1-20.sles15.x86_64.rpm
    $ sudo zypper install rstudio-connect-1.8.4.1-20.sles15.x86_64.rpm
    
    $ curl -O https://cdn.rstudio.com/connect/1.8.4/rstudio-connect-1.8.4.1-20.sles12.x86_64.rpm
    $ sudo zypper install rstudio-connect-1.8.4.1-20.sles12.x86_64.rpm
    

Step 2: Configure RStudio Connect using the Setup Tool#

The Setup Tool 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.

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 Tool - Post Installation Procedures documentation.

Note

The Setup Tool 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.

Additional information

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

Supported Setup Tool Features Overview

Licensing

Setup Tool Feature Support Included Recommended Instructions
Online Evaluation               X
Offline Evaluation Follow the Connectivity Requirements documentation.
Online License Key               X
Offline License Key               X
Floating License               For this option, please use the Manual Installation and reference the Floating Licenses documentation.

Authentication

Setup Tool Feature Support Included Recommended Instructions
SAML               X
LDAP               X
PAM               X
OAuth (OIDC)               X
Password Built-in               X

Environments

Setup Tool Feature Support Included Recommended Instructions
R Installations               X
Python Installations               X
Recommended Packages Can be installed post-setup: Instructions

Web Server

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

Mail Server

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

Databases

Setup Tool Feature Support Included Recommended Instructions
SQLite         X Additional Information
PostgreSQL         X Additional Information

Additional Configuration Options

Setup Tool Feature Support Included Recommended Instructions
Version Control Can be configured post-setup: Instructions
Data Sources Can be configured post-setup: Instructions
Load Balancing Can be configured post-setup: Instructions