Installing RStudio Workbench#
Step 1. Install R & Python#
Installing R is required.
Install a version of R on the server following the steps to Install R.
Our recommended installation instructions for R allow you to make multiple versions of R available and avoid replacing existing versions of R when updating system packages.
Optionally, install Python if you wish to integrate RStudio Workbench with VS Code and/or Jupyter.
- Install a version of Python on the server following the steps to Install Python from Source.
Step 2. Download and install#
Multiple load-balanced instances of RStudio Workbench
If you have multiple load-balanced instances of RStudio Workbench, there is a new requirement for a Postgres metadata database to upgrade to version 1.4 or greater. If you attempt to install/upgrade to version 1.4 or greater and do not have a Postgres metadata database configured, RStudio Workbench will not start. See the Database section for more information.
Download and install RStudio Workbench:
$ curl -O https://download2.rstudio.org/server/rhel8/x86_64/rstudio-workbench-rhel-2022.07.0-548.pro5-x86_64.rpm $ sudo yum install rstudio-workbench-rhel-2022.07.0-548.pro5-x86_64.rpm
$ curl -O https://download2.rstudio.org/server/centos7/x86_64/rstudio-workbench-rhel-2022.07.0-548.pro5-x86_64.rpm $ sudo yum install rstudio-workbench-rhel-2022.07.0-548.pro5-x86_64.rpm
$ sudo apt-get install gdebi-core $ curl -O https://download2.rstudio.org/server/bionic/amd64/rstudio-workbench-2022.07.0-548.pro5-amd64.deb $ sudo gdebi rstudio-workbench-2022.07.0-548.pro5-amd64.deb
$ sudo apt-get install gdebi-core $ curl -O https://download2.rstudio.org/server/jammy/amd64/rstudio-workbench-2022.07.0-548.pro5-amd64.deb $ sudo gdebi rstudio-workbench-2022.07.0-548.pro5-amd64.deb
$ curl -O https://download2.rstudio.org/server/opensuse15/x86_64/rstudio-workbench-2022.07.0-548.pro5-x86_64.rpm $ sudo zypper install rstudio-workbench-2022.07.0-548.pro5-x86_64.rpm
- The RStudio Workbench configuration file (
/etc/rstudio/rserver.conf) is empty. This is intentional, since this file should contain only settings you are overriding with custom values.
- Even with this file being empty, the server works out of the box on the default port 8787.
For additional information, please see the RStudio Workbench Administration Guide Appendix.
Step 3. Activate license#
Run the following command to determine the status of your license and verify that your evaluation license is active:Terminal
$ sudo rstudio-server license-manager status
Using online activation
If you already have a license key and your server is in an online environment, you can activate the license using the following command:Terminal
$ sudo rstudio-server license-manager activate <LICENSE-KEY>
<LICENSE-KEY>is the license key that was provided to you.
Using offline activation
If your server is offline, you can use this app to activate your offline license. For more information about offline license activation, refer to the offline activation section of the RStudio Workbench Administration Guide.
Using a floating license server
If you are using a floating licensing server, refer to the floating licensing section of the RStudio Workbench Administration Guide.
For more information on different options of activating your license, refer to the license management section of the RStudio Workbench Administration Guide.
Step 4. Verify installation#
- Now, you can visit RStudio Workbench in a browser at
<SERVER-ADDRESS>with the DNS name or IP address of the server.
The RStudio Job Launcher provides an extensible and reusable mechanism for RStudio applications to start processes within various batch processing systems (e.g., SLURM) and container orchestration platforms (e.g., Kubernetes). RStudio products integrate with the Job Launcher to allow you to utilize your existing cluster hardware for maximum process isolation and operations efficiency.
We offer the following integration options:
Additionally, the RStudio Job Launcher Administration Guide is available here.
We understand that older configurations may be incompatible with newer versions of RStudio. If you require an older version, we have several versions archived and available on our Older Versions of RStudio page.
- RStudio is limited on the support that we can provide for older versions
- If you are using an older version and run into any issues, you may be asked to upgrade to receive support
Please review our Support Agreement for more detail on our product support policy.