Skip to content

Installing RStudio Workbench#

These instructions describe how to install RStudio Workbench, formerly RStudio Server Pro1, on a Linux server.

Step 1. Install R#

  • Install a version of R on the server following the steps to Install R.

    Info

    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.

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/centos8/x86_64/rstudio-workbench-rhel-2021.09.0-351.pro6-x86_64.rpm
    $ sudo yum install rstudio-workbench-rhel-2021.09.0-351.pro6-x86_64.rpm
    
    $ curl -O https://download2.rstudio.org/server/centos7/x86_64/rstudio-workbench-rhel-2021.09.0-351.pro6-x86_64.rpm
    $ sudo yum install rstudio-workbench-rhel-2021.09.0-351.pro6-x86_64.rpm
    
    $ sudo apt-get install gdebi-core
    $ curl -O https://download2.rstudio.org/server/bionic/amd64/rstudio-workbench-2021.09.0-351.pro6-amd64.deb
    $ sudo gdebi rstudio-workbench-2021.09.0-351.pro6-amd64.deb
    
    $ sudo apt-get install gdebi-core
    $ curl -O https://download2.rstudio.org/server/debian9/x86_64/rstudio-workbench-2021.09.0-351.pro6-amd64.deb
    $ sudo gdebi rstudio-workbench-2021.09.0-351.pro6-amd64.deb
    
    $ curl -O https://download2.rstudio.org/server/opensuse/x86_64/rstudio-workbench-2021.09.0-351.pro6-x86_64.rpm
    $ sudo zypper install rstudio-workbench-2021.09.0-351.pro6-x86_64.rpm
    
    $ curl -O https://download2.rstudio.org/server/opensuse15/x86_64/rstudio-workbench-2021.09.0-351.pro6-x86_64.rpm
    $ sudo zypper install rstudio-workbench-2021.09.0-351.pro6-x86_64.rpm
    

On installation:

  • 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#

Step 4. Verify installation#

  • Now, you can visit RStudio Workbench in a browser at http://<SERVER-ADDRESS>:8787 and replacing <SERVER-ADDRESS> with the DNS name or IP address of the server.

Additional Information#

RStudio Launcher

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.

Previous versions#

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.

Please consider:

  • 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.


  1. We have renamed RStudio Server Pro to RStudio Workbench. This change reflects the product’s growing support for a wide range of different development environments. Please see our official Announcement and review our FAQ regarding the name change from RStudio Server Pro to RStudio Workbench. 

Back to top