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

We recommend creating a backup of the Posit Connect database and data directory before upgrading. If you need to roll back to a prior version, you will need these backups. See the Downgrading section for more details.

Upgrading Posit Connect requires limited downtime. Scheduled document renders are interrupted, and connections to running applications and APIs are closed. We recommend upgrading during a period of low usage. Users can be warned ahead of an upgrade with system messages.

The Posit Connect version number is visible on the left-hand navigation pane of the Posit Connect dashboard.

The latest version of Posit Connect is available on the download page along with release notes.

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.

You can upgrade Posit Connect by using one of the following methods:

• The installation/upgrade script or

• The latest .rpm or .deb file:

  • Download the latest .rpm or .deb file for your distribution.

  • Run the install command:

    Ubuntu

    sudo gdebi <rstudio-connect-version.deb>

    Red Hat/CentOS

    sudo yum install <rstudio-connect-version.rpm>

    SUSE

    sudo zypper install <rstudio-connect-version.rpm>

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 file, copy it to your offline server, and run the installation command (shown above).

The new version of Posit Connect installs on top of an earlier installation. Existing configuration settings are respected. During installation the Connect service is restarted. Total downtime is less than 10 minutes.

Note

The /etc/rstudio-connect/rstudio-connect-migration.gcfg configuration file is modified during product updates. The Configuration Migration section describes this file and how it is managed. The migration file acts as a staging area for new or updated options. Review the contents of this file after upgrading and move its contents to the main /etc/rstudio-connect/rstudio-connect.gcfg configuration file.

Please see the Manual Installation steps for additional information.