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.

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. See the Database section for more information.

  • Download and install Workbench:

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

On installation:

  • The 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 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 Posit. If you require an older version, we have several versions archived and available on our Older Versions of RStudio/Posit 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.