Upgrade Posit Connect

This section describes how to upgrade Posit Connect. Upgrading Connect requires limited downtime (typically less than 10 minutes). See Install Posit Professional Products for alternative upgrade instructions (e.g., cloud marketplaces, or using Helm charts with Kubernetes).

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.

Upgrade planning

  • During the upgrade, the Connect service is restarted.
  • Scheduled document renders are not interrupted.
  • Connections to running applications and APIs are closed.
  • Users might be prompted with a warning ahead of an upgrade using System Messages.

New features, deprecations, and breaking changes are announced in the Release Notes and the Product Information email subscription list. When performing an upgrade from a much older version of Connect, reviewing the detailed Release Notes is strongly recommended.

Download and run the script

To perform an upgrade, download and run the same script used to install Connect. The script installs a new version of Connect on top of the earlier one. Existing configuration settings are respected unless otherwise mentioned in the release notes.

The installation script must be run by a privileged user or a user with sudo privileges.

To update Connect, download and run the installation/upgrade script:

curl -Lo rsc-installer.sh https://cdn.rstudio.com/connect/installer/installer-latest-release.sh
sudo -E bash ./rsc-installer.sh 2023.09.0

More information about the script can be found in the Installation section of this guide.

Offline or manual upgrade

If you need to upgrade your version of Connect in an offline environment:

  • Download the latest .rpm or .deb installation files for your distribution.
  • Copy the file to your offline server.
  • Install using the appropriate package manager for your distribution.

Please see the Manual Installation steps or the Upgrading section of the Admin Guide for additional information.

Additional upgrade information

The Upgrading section of the Server Management page in this guide offers additional information on upgrading Connect.