Skip to content

Upgrade Linux OS and Posit Team — Alternative Path, Upgrade OS In-Place

flowchart LR

    subgraph box[<b>Recommended Approach</b>]
    A ~~~|"<a style="text-decoration:none" href="../">Overview</a>"|A
    B ~~~|"<a style="text-decoration:none" href="../phase1-upgrade"><p style="background-color:none">Phase 1\n Install\n Upgraded\n Products</a>"|B
    C ~~~|"<a style="text-decoration:none" href="../phase1-test"><p style="background-color:none">Test\n Phase 1</a>"|C
    D ~~~|"<a style="text-decoration:none" href="../phase2-migrate"><p style="background-color:none">Phase 2\n Migrate\n Data</a>"|D
    E ~~~|"<a style="text-decoration:none" href="../rollout"><p style="background-color:none">Rollout</a>"|E
    F ~~~|"<b>Upgrade\n OS in place</b>"|F

    click A href "../"
    click B href "../phase1-upgrade"
    click C href "../phase1-test"
    click D href "../phase2-migrate"
    click E href "../rollout"

    classDef activePage fill:#447099, stroke:#D1DBE5, color:#fff, padding:4px
    classDef inactivePage fill:#D1DBE5, stroke:#447099, color:#151515, padding:4px
    classDef activeDesc font-size:20px
    class A,B,C,D,E inactivePage
    class F activePage
    style box rx:40,ry:40


An in-place upgrade of the Linux OS is generally not recommended, but can be considered if:

  • You are upgrading from a supported Posit product version to another supported product version. Refer to the list of Supported Pro product versions to determine applicability.

  • You have a staging server available to perform all work in an isolated environment. Without a staging environment, troubleshooting issues is challenging because the old environment is not available for reference.

  • You are satisfied with the support (if any) provided by your OS vendor during the in-place OS upgrade.

  • You recognize that upgrading the OS in place presents the opportunity for OS system library incompatibility issues to arise, which are often intermittent, difficult-to-troubleshoot, and may arise months after the upgrade.

If the Posit product(s) are out of support, use the recommended 2-phased approach instead to update your OS and product(s).


Do not attempt this approach if the Posit product version(s) in production are no longer supported. Refer to the list of Supported Pro product versions to determine applicability.

Upgrading the OS in-place requires any software installed outside of the Linux package manager to be reinstalled for the new OS. This includes, but is not limited to:

  • Reinstallation of the Posit product(s).
  • Reinstallation of all Python versions.
  • Reinstallation of all R versions.
  • Reinstallation of all Quarto versions.

When conducting an OS upgrade in-place, all work should be performed in a staging environment to minimize downtime and operational risk.

  1. Capture a backup, and duplicate the production environment in staging.

  2. Upgrade the OS in staging, then reinstall the Posit product(s) at the same version as in production.

  3. Reinstall all versions of Python, all versions of R, and all versions of Quarto at the same version as production.

  4. Reinstall any other software installed outside of the Linux package manager (drivers, for example).

  5. Existing Python and R package libraries on Workbench and content runtime caches on Connect must be cleared because they are incompatible with the new Linux OS. Remove the package libraries on Workbench and content runtime caches on Connect and rebuild as appropriate.

  6. Upgrade the Posit product(s) per the applicable product documentation: