Step 1: Download and Install RStudio Connect

Overview

RStudio offers two ways to download and install RStudio Connect:

  • Guided install
  • Manual install
Prerequisites

Before proceeding with the installation, you must:

  • Meet the Requirements for RStudio Connect
  • Install R on the server using the steps provided by RStudio

Step 1a: Download and install RStudio Connect

After you install R, choose one of the installation methods and execute the following commands to download and install RStudio Connect.

Info

RStudio recommends using the Guided installation method that works across all supported Linux distributions. If the Guided installation method isn't appropriate for your environment, then proceed with the Manual installation procedures.


Guided installation

In addition to downloading and installing RStudio Connect, the Guided installation method validates the GPG (GNU Privacy Guard) key of the downloaded package and includes support for offline users.

Guided installation script procedures:

$ curl -LO https://rstudio-connect.s3.amazonaws.com/rsc-installer.sh
$ bash ./rsc-installer.sh 1.8.2-10

The script interactively prompts for your approval as it downloads the RStudio Connect package, installs the required dependencies, and installs RStudio Connect.


Manual installation

Manual installation procedures:

$ curl -O https://s3.amazonaws.com/rstudio-connect/rstudio-connect-1.8.2-10.el8.x86_64.rpm
$ sudo yum install rstudio-connect-1.8.2-10.el8.x86_64.rpm
$ curl -O https://s3.amazonaws.com/rstudio-connect/rstudio-connect-1.8.2-10.el.x86_64.rpm
$ sudo yum install rstudio-connect-1.8.2-10.el.x86_64.rpm
$ sudo apt-get install gdebi-core
$ curl -O https://s3.amazonaws.com/rstudio-connect/rstudio-connect_1.8.2-10_amd64.deb
$ sudo gdebi rstudio-connect_1.8.2-10_amd64.deb
$ curl -O https://s3.amazonaws.com/rstudio-connect/rstudio-connect-1.8.2-10.sles15.x86_64.rpm
$ sudo zypper install rstudio-connect-1.8.2-10.sles15.x86_64.rpm
$ curl -O https://s3.amazonaws.com/rstudio-connect/rstudio-connect-1.8.2-10.sles12.x86_64.rpm
$ sudo zypper install rstudio-connect-1.8.2-10.sles12.x86_64.rpm

Step 1b: Verify installation

You can verify that the service is running by executing the following command:

Terminal

$ sudo systemctl status rstudio-connect

Step 1c: Verify and activate your license

Run the following command to determine the status of your license and verify that your evaluation license is active:

Terminal

$ sudo /opt/rstudio-connect/bin/license-manager status

If would you like continue configuring RStudio Connect using the trial evaluation license, then skip to Step 1d: Initial configuration.

If you already have a license key, then follow the License activation procedures:

License activation procedures

There are several options for activating your license:

Online activation

If your server is in an online environment and you already have the license key, then activate the license using the following command (the <LICENSE-KEY> is the license key that was provided to you):

Terminal

$ sudo /opt/rstudio-connect/bin/license-manager activate <LICENSE-KEY>

For additional information about online activation, refer to the Product Activation section of the Admin Guide.


Offline activation

If you are working in an offline environment, then refer to the License Server Offline Activation section of the Admin Guide.


Floating license

If your server is up and running and you need to configure RStudio Connect to use a floating license, then the Using Floating Licensing section of the Admin Guide provides additional information.


Step 1d: Initial configuration

Now that you verified that RStudio Connect successfully installed, it is important to configure the following before logging into RStudio Connect for the first time:

  • The server's address property
  • The server's email properties
  • Authentication