Skip to content

Installing Posit Workbench#

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 Workbench, formerly RStudio Workbench, on a Linux server. See Install Posit Professional Products for alternative installation instructions.

Posit End User License Agreement

This page includes instructions for downloading Posit professional products. Download and/or use of these products is governed under the terms of the Posit End User License Agreement. By downloading you agree to the terms posted there.

Step 1. Install R & Python#

Install R

Installing R is required.

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

Install Python

Optionally, install Python if you wish to integrate Workbench with VS Code and/or Jupyter.

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

Step 2. Download and install#

Multiple load-balanced instances of Workbench

If you have multiple load-balanced instances of 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, Workbench will not start. Contact support for assistance.

Additionally, Posit switched to a calendar-based versioning scheme; all semantic versions were released prior to all calendar-based Workbench versions. For example, version 2021.09.1 is greater than version 1.4.

  • Download and install Workbench version 2023.03.1-446.pro1:

    $ curl -O https://download2.rstudio.org/server/rhel8/x86_64/rstudio-workbench-rhel-2023.03.1-446.pro1-x86_64.rpm
    $ sudo yum install rstudio-workbench-rhel-2023.03.1-446.pro1-x86_64.rpm
    
    $ curl -O https://download2.rstudio.org/server/centos7/x86_64/rstudio-workbench-rhel-2023.03.1-446.pro1-x86_64.rpm
    $ sudo yum install rstudio-workbench-rhel-2023.03.1-446.pro1-x86_64.rpm
    
    $ curl -O https://download2.rstudio.org/server/rhel9/x86_64/rstudio-workbench-rhel-2023.03.1-446.pro1-x86_64.rpm
    $ sudo yum install rstudio-workbench-rhel-2023.03.1-446.pro1-x86_64.rpm
    
    $ sudo apt-get install gdebi-core
    $ curl -O https://download2.rstudio.org/server/bionic/amd64/rstudio-workbench-2023.03.1-446.pro1-amd64.deb
    $ sudo gdebi rstudio-workbench-2023.03.1-446.pro1-amd64.deb
    
    $ sudo apt-get install gdebi-core
    $ curl -O https://download2.rstudio.org/server/jammy/amd64/rstudio-workbench-2023.03.1-446.pro1-amd64.deb
    $ sudo gdebi rstudio-workbench-2023.03.1-446.pro1-amd64.deb
    
    $ curl -O https://download2.rstudio.org/server/opensuse15/x86_64/rstudio-workbench-2023.03.1-446.pro1-x86_64.rpm
    $ sudo zypper install rstudio-workbench-2023.03.1-446.pro1-x86_64.rpm
    

On installation:

The Workbench configuration file (/etc/rstudio/rserver.conf) contains default configuration to run Workbench using local launcher sessions, without SSL enabled, listening on port 8787.

For additional information, please see the 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>
    

    where <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 Workbench Administration Guide.

    Using a floating license server

    If you are using a floating licensing server, refer to the floating licensing section of the Workbench Administration Guide.

    For more information on different options of activating your license, refer to the license management section of the Workbench Administration Guide.

Step 4. Verify installation#

  • Now, you can visit 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#

Posit Launcher

The Posit Job Launcher (formerly the RStudio Job Launcher) provides an extensible and reusable mechanism for Posit applications to start processes within various batch processing systems (e.g., SLURM) and container orchestration platforms (e.g., Kubernetes). Posit 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 Job Launcher Administration Guide is available here.

Previous versions#

We understand that older configurations may be incompatible with newer versions of our products. If you require a previous version, we have several supported versions available on our Previous Versions page.

Please consider:

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