Upgrade RStudio Connect#
Upgrading RStudio Connect requires limited downtime (typically less than 10 minutes).
Upgrade planning#
- During the upgrade, the RStudio Connect service is restarted.
- Scheduled document renders are not interrupted.
- Connections to running applications and APIs are closed.
- Users can be prompted with a warning ahead of an upgrade using System Messages.
Info
New features, deprecations, and breaking changes are announced on the RStudio Blog for each version release. When performing an upgrade from a much older version of RStudio Connect, it is recommended that you review the detailed Release Notes.
Download and run the script#
To perform an upgrade, download and run the same script used to install RStudio Connect. The script installs a new version of RStudio Connect on top of the earlier one. Existing configuration settings are respected unless otherwise mentioned in the release notes.
Note
The installation script must be run by a privileged user or a user with sudo privileges.
-
To update RStudio Connect, download and run the installation/upgrade script:
$ curl -Lo rsc-installer.sh https://cdn.rstudio.com/connect/installer/installer-v1.9.5.sh $ sudo -E bash ./rsc-installer.sh 2021.11.0
More information about the script can be found here.
Offline or manual upgrade#
If you need to upgrade your version of RStudio Connect in an offline environment:
- Download the latest
.rpmor.debinstallation files for your distribution. - Copy the file to your offline server.
- Run the installation/upgrade script.
Please see the Manual Installation steps or the Upgrading section of the Admin Guide for additional information.
Additional upgrade information#
The Admin Guide offers additional information that expands on the information for upgrading RStudio Connect.