Install Posit Connect#
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 Posit Connect, formerly RStudio Connect, on a Linux server. See Install Posit Professional Products for alternative installation instructions.
Posit highly recommends installing and initially configuring Connect with the Setup Assistant, formerly the Setup Tool, referencing the steps below. The Setup Assistant provides a user-friendly UI to install, initially configure, test, and deploy Connect.
Install using .rpm
or .deb
files
Connect can be installed manually by using .rpm
or .deb
files. Although this manual installation method is available, it is only needed for rare use cases, and the Setup Assistant installation is preferred for most users. Please see the Manual Installation documentation for more information.
This installation method uses the Setup Assistant to install Connect. The Setup Assistant is currently only available for first-time installations and cannot be used for making updates to your configuration.
If you are upgrading from an older version to a newer one, please refer to our Upgrade guide.
Before proceeding with the installation, you must:
- Meet the Requirements for Connect
-
Review the Setup Assistant information checklist and verify that you have the required information:
Setup Assistant information checklist
The following information will need to be provided in the Setup Assistant:- A license key (unless running an evaluation)
- Version(s) of R users will need on the the sever
- Version(s) of Python users will need on the server
- Authentication integration details
- Git credentials (optional)
- The public server or hostname of the Connect server
- SSL/TLS certificates (recommended)
- Public certificate file
- Private key file
- SMTP mail server integration details
- The hostname or IP address of the SMTP server used for email delivery
- Email address used by Connect to send outbound email
- PostgreSQL database details (if you plan on configuring load balancing)
Step 1: Download and run the installation script#
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.
The installation script works across all supported Linux distributions, validates the GPG key of the downloaded package, and includes support for offline use.
Note
The installation script must be run by a privileged user or a user with sudo
privileges.
To install Connect, download and run the installation script:
$ curl -Lo rsc-installer.sh https://cdn.rstudio.com/connect/installer/installer-v6.4.0.sh
$ sudo -E bash ./rsc-installer.sh 2023.03.0
The script:
- Downloads missing required dependencies
- Downloads the Connect package
- Installs Connect
After the installation is complete, you will be given the choice to:
- Proceed with configuration using the Setup Assistant and continue to Step 2. Configure Connect using the Setup Assistant, or
- Exit the installer and configure Connect using the Manual installation procedures.
Troubleshooting Information
If you are not able to successfully install Connect using the installation script, then please review and complete the troubleshooting steps provided in the installation script's output. If you still require additional help, please refer to the troubleshooting article published by Support.
Connect Install Files#
-
If you don't have an
.rpm
or.deb
file containing Connect and all of its dependencies (other than R), use one of the following to download and install Connect:Connect Install files
If you don't have an
.rpm
or.deb
file containing Connect and all of its dependencies (other than R), use one of the following to download and install Connect:$ curl -O https://cdn.rstudio.com/connect/2023.03/rstudio-connect-2023.03.0.el9.x86_64.rpm $ sudo yum install rstudio-connect-2023.03.0.el9.x86_64.rpm
$ curl -O https://cdn.rstudio.com/connect/2023.03/rstudio-connect-2023.03.0.el8.x86_64.rpm $ sudo yum install rstudio-connect-2023.03.0.el8.x86_64.rpm
$ curl -O https://cdn.rstudio.com/connect/2023.03/rstudio-connect-2023.03.0.el7.x86_64.rpm $ sudo yum install rstudio-connect-2023.03.0.el7.x86_64.rpm
$ curl -O https://cdn.rstudio.com/connect/2023.03/rstudio-connect-2023.03.0.amazonlinux2.x86_64.rpm $ sudo yum install rstudio-connect-2023.03.0.amazonlinux2.x86_64.rpm
$ sudo apt-get install gdebi-core $ curl -O https://cdn.rstudio.com/connect/2023.03/rstudio-connect_2023.03.0~ubuntu22_amd64.deb $ sudo gdebi rstudio-connect_2023.03.0~ubuntu22_amd64.deb
$ sudo apt-get install gdebi-core $ curl -O https://cdn.rstudio.com/connect/2023.03/rstudio-connect_2023.03.0~ubuntu20_amd64.deb $ sudo gdebi rstudio-connect_2023.03.0~ubuntu20_amd64.deb
$ sudo apt-get install gdebi-core $ curl -O https://cdn.rstudio.com/connect/2023.03/rstudio-connect_2023.03.0~ubuntu18_amd64.deb $ sudo gdebi rstudio-connect_2023.03.0~ubuntu18_amd64.deb
$ curl -O https://cdn.rstudio.com/connect/2023.03/rstudio-connect-2023.03.0.sles15.x86_64.rpm $ sudo zypper install rstudio-connect-2023.03.0.sles15.x86_64.rpm
Please see the Manual Installation documentation for more information.
Step 2: Configure Connect using the Setup Assistant#
The Setup Assistant is designed to step through several initial configuration options, with a primary focus on validating your licensing and authentication settings.
If you need to pause the configuration process:
- You may close your browser.
- Return to the configuration process later with the saved state.
The Setup Assistant supports the following flags:
Option | Function |
---|---|
-h |
Print help |
-x |
Launches the Setup Assistant (requires Connect installation) |
To use one of the flags listed above, execute the following command:
sudo -E bash ./rsc-installer.sh <flag>
For example, if you want to launch the Setup Assistant after manually installing Connect, run:
sudo -E bash ./rsc-installer.sh -x
Step 3: Additional integration and validation tasks#
Upon completion, you will be redirected back to this site for a review of additional recommended integration and validation tasks. These recommended integration and validation tasks are available in the Setup Assistant - Post Installation Procedures documentation.
Note
The Setup Assistant does not currently support offline evaluations or floating license server configurations. Refer to the Supported Setup Tool Features Overview Licensing section, shown below, for more information.
The following features can be initially configured with the Setup Assistant:
Supported Setup Assistant Features Overview
Setup Assistant Feature | Support Included | Recommended Instructions |
---|---|---|
Online Evaluation | ![]() |
|
Offline Evaluation | ![]() |
|
Online License Key | ![]() |
|
Offline License Key | ![]() |
|
Floating License | For this option, please use the Manual Installation and reference the Floating Licenses documentation. |
Setup Assistant Feature | Support Included | Recommended Instructions |
---|---|---|
SAML | ![]() |
|
LDAP | ![]() |
|
PAM | ![]() |
|
OAuth (OIDC) | ![]() |
|
Password Built-in | ![]() |
Setup Assistant Feature | Support Included | Recommended Instructions |
---|---|---|
R Installations | ![]() |
|
Python Installations | ![]() |
|
Recommended System Packages | ![]() |
Setup Assistant Feature | Support Included | Recommended Instructions |
---|---|---|
HTTPS | ![]() |
This is recommended. |
HTTP | ![]() |
|
Proxy Server | Can be configured post-setup: Instructions |
Setup Assistant Feature | Support Included | Recommended Instructions |
---|---|---|
SMTP | ![]() |
|
Sendmail | Not the recommended option, but if necessary, please use the Manual Installation option and reference the Email Setup documentation. | |
Disable Mail | ![]() |
Not the recommended option. Additionally, if email is disabled, then several Connect features will not function. |
Setup Assistant Feature | Support Included | Recommended Instructions |
---|---|---|
SQLite | ![]() |
Additional Information |
PostgreSQL | ![]() |
Additional Information |
Setup Assistant Feature | Support Included | Recommended Instructions |
---|---|---|
Version Control | ![]() |
|
Data Sources | Can be configured post-setup: Instructions | |
Load Balancing | Can be configured post-setup: Instructions | |
Service, Audit, and Access Logging | ![]() |
Additional Information |