Install Posit Workbench
These instructions describe how to install Workbench on a Linux server.
For alternative installation instructions, see our recommended installation paths.
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. The same instructions apply if you still use a legacy RStudio Server Pro license configuration (no launcher enabled).
Prerequisites
Before you install, review the Requirements and ensure they are met.
Install Workbench
Step 1: Install R & Python
Install R
Follow the steps to Install R.
NoteOur 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
Installing Python is optional unless you need to run JupyterLab or Jupyter Notebook sessions, or to run Python code in any IDE.
Install a version of Python on the server following the steps to Install Python.
NoteRStudio Pro and VS Code do not require Python. However, we recommend installing Python to give users the most choice and the option to develop in Python, R, or both.
If you pre-install R or Python with a cloud-init or Amazon Elastic Compute Cloud (EC2) user-data script, the script runs once at first boot, before networking is fully established. If the network is not ready, apt-get and curl can fail silently and leave a server with no runtimes installed. Before you start Workbench, confirm that R and Python are present on the server. If either runtime is missing, re-run the Install R and Install Python steps.
Step 2: Download and install
- If you have not already done so, add the Posit package repository:
Follow the Red Hat Repository Setup instructions to add the Posit package repository.
Follow the Debian Repository Setup instructions to add the Posit package repository.
Follow the SUSE Repository Setup instructions to add the Posit package repository.
If you need to use Workbench with SELinux in enforcing mode, follow the steps provided in the Access and Security - SELinux Configuration documentation to install the SELinux policy module.
Install Workbench version 2026.11.0:
Terminal
sudo dnf install rstudio-server-2026.11.0+203.pro4(Optional) To disable automatic updates, lock the rstudio-server package:
Terminal
sudo dnf install 'dnf-command(versionlock)'
sudo dnf versionlock add rstudio-serverTerminal
sudo apt-get update
sudo apt-get install rstudio-server=2026.11.0+203.pro4(Optional) To disable automatic updates, lock the rstudio-server package:
Terminal
sudo apt-mark hold rstudio-serverTerminal
sudo zypper install rstudio-server-2026.11.0+203.pro4(Optional) To disable automatic updates, lock the rstudio-server package:
Terminal
sudo zypper addlock rstudio-serverFor air-gapped (offline) environments, follow this procedure instead.
Download the appropriate
.rpmfile on an internet-connected machine:- RHEL 10 (x86_64):
https://dl.posit.co/public/pro/rpm/el/10/x86_64/rstudio-workbench-rhel-2026.11.0-203.pro4-x86_64.rpm - RHEL 10 (ARM):
https://dl.posit.co/public/pro/rpm/el/10/aarch64/rstudio-workbench-rhel-2026.11.0-203.pro4-aarch64.rpm - RHEL 9 (x86_64):
https://dl.posit.co/public/pro/rpm/el/9/x86_64/rstudio-workbench-rhel-2026.11.0-203.pro4-x86_64.rpm - RHEL 8 (x86_64):
https://dl.posit.co/public/pro/rpm/el/8/x86_64/rstudio-workbench-rhel-2026.11.0-203.pro4-x86_64.rpm
- RHEL 10 (x86_64):
Securely copy the file to the air-gapped environment following your approved process.
Install the package:
Terminal (x86_64)
sudo dnf install ./rstudio-workbench-rhel-2026.11.0-203.pro4-x86_64.rpmTerminal (ARM)
sudo dnf install ./rstudio-workbench-rhel-2026.11.0-203.pro4-aarch64.rpmDownload the appropriate
.debfile on an internet-connected machine:- Ubuntu 26 (x86_64):
https://dl.posit.co/public/pro/deb/ubuntu/pool/resolute/main/r/rs/rstudio-server_2026.11.0+203.pro4/rstudio-workbench-2026.11.0-203.pro4-amd64.deb - Ubuntu 26 (ARM):
https://dl.posit.co/public/pro/deb/ubuntu/pool/resolute/main/r/rs/rstudio-server_2026.11.0+203.pro4/rstudio-workbench-2026.11.0-203.pro4-arm64.deb - Ubuntu 24 (x86_64):
https://dl.posit.co/public/pro/deb/ubuntu/pool/noble/main/r/rs/rstudio-server_2026.11.0+203.pro4/rstudio-workbench-2026.11.0-203.pro4-amd64.deb - Ubuntu 24 (ARM):
https://dl.posit.co/public/pro/deb/ubuntu/pool/noble/main/r/rs/rstudio-server_2026.11.0+203.pro4/rstudio-workbench-2026.11.0-203.pro4-arm64.deb - Ubuntu 22 (x86_64):
https://dl.posit.co/public/pro/deb/ubuntu/pool/jammy/main/r/rs/rstudio-server_2026.11.0+203.pro4/rstudio-workbench-2026.11.0-203.pro4-amd64.deb - Debian 13 (x86_64):
https://dl.posit.co/public/pro/deb/debian/pool/trixie/main/r/rs/rstudio-server_2026.11.0+203.pro4/rstudio-workbench-2026.11.0-203.pro4-amd64.deb
- Ubuntu 26 (x86_64):
Securely copy the file to the air-gapped environment following your approved process.
Install the package:
Terminal (x86_64)
sudo apt install ./rstudio-workbench-2026.11.0-203.pro4-amd64.debTerminal (ARM)
sudo apt install ./rstudio-workbench-2026.11.0-203.pro4-arm64.deb- Download the
.rpmfile on an internet-connected machine: - Securely copy the file to the air-gapped environment following your approved process.
Terminal
sudo zypper install ./rstudio-workbench-2026.11.0-203.pro4-x86_64.rpmThe installed Workbench package and its service and management commands are named rstudio-server. For example, you manage the service with sudo rstudio-server restart. This naming reflects the product’s earlier name, RStudio Server Pro.
Upon installation, Workbench configuration file (/etc/rstudio/rserver.conf) contains a default configuration to run Workbench using local launcher sessions, without SSL enabled, listening on port 8787.
We strongly recommend running Workbench on a secured network or enabling TLS/SSL. Review the Secure Sockets (SSL) documentation before you continue the installation.
Step 3: Activate license
Run the following command to determine the status of your license:
sudo rstudio-server license-manager statusPosit recommends using license file activation. License files work well in all environments including ephemeral, container-based, or air-gapped environments. See License activation methods or the License Management page for more details.
If you have a license file:
Transfer the file to the server hosting Workbench.
Ensure the license file is owned by the Workbench service user and is not readable by other users, then copy the file into
/var/lib/rstudio-server:sudo chown rstudio-server <license-file>.lic sudo chmod 0600 <license-file>.lic sudo cp -a <license-file>.lic /var/lib/rstudio-server/
The default Workbench server-user user is rstudio-server. If your installation is configured with a different server-user, ensure the file is owned by that user.
If the server uses SELinux in enforcing mode, update the security context on the license file:
sudo restorecon /var/lib/rstudio-server/<license-file>.licRestart Workbench for the license to take effect:
sudo rstudio-server restart
Verify the installation
To check that the installation was successful, open Workbench in a browser at http://<SERVER-ADDRESS>:8787, replacing <SERVER-ADDRESS> with the DNS name or IP address of the server.
Verify the deployment with VIP
For a deeper check that Workbench functions end to end, use Verified Installation of Posit (VIP), a non-destructive test suite that validates login, IDE launch, sessions, package installation, data source connectivity, and runtimes against a running deployment.
Install VIP on a machine that can reach the server. VIP requires uv:
uv tool install posit-vip
vip installRun the verification against your deployment, replacing <product-url> with the URL of your Workbench server:
vip verify --workbench-url <product-url> --interactive-authThe --interactive-auth flag opens a browser so that VIP can complete the login flow through your identity provider. On a server without a display, use --headless-auth instead. Headless authentication drives a username and password login rather than an interactive single sign-on (SSO) session, so you must first export the credentials VIP logs in with:
export VIP_TEST_USERNAME="<username>"
export VIP_TEST_PASSWORD="<password>"
vip verify --workbench-url <product-url> --headless-authAfter the run, vip verify reports pass or fail for each check in the terminal and writes the results to report/results.json. To render a shareable HTML report of the results, run vip report. This command requires the Quarto CLI:
vip reportIf any checks fail, the report identifies the failing area so that you can correct the configuration before users log in.
VIP is an open-source project. See the VIP documentation for the full list of checks and configuration options.
Next steps
After you install and verify Workbench, complete the Initial Configuration to secure the server, configure IDEs, and set up authentication before users sign in.