Title: Software Versions management Author: WordPress VIP Documentation Published: August 9, 2022 Last modified: November 7, 2024 --- 1. [Infrastructure](https://docs.wpvip.com/infrastructure/) 2. [VIP Platform environments](https://docs.wpvip.com/infrastructure/environments/) 3. Software Versions management # Software Versions management The versions of software that are deployed to a WordPress or a Node.js VIP Platform environment can be managed in [the VIP Dashboard](https://docs.wpvip.com/vip-dashboard/) or with the VIP-CLI command: `[vip config software update  [options]](https://docs.wpvip.com/vip-cli/commands/config/software/update/)`. * The **Software Versions** panel is environment-specific (e.g., Production, Develop). A different environment can be selected from the dropdown located at the upper left of the VIP Dashboard application view. * In the dropdown lists of software versions, the version labeled “Active” is the version currently deployed to the environment. * Environments can be updated to a greater or lesser version of software, limited only to the available versions listed in the versions dropdown for that software. * Each software update applied to an environment must complete before another can begin. * Environments continue to be available throughout the update process. * Available security updates for active versions of software are automatically applied to environments. **VIP-CLI command examples** For demonstration purposes, the `` value `example-app` and the `` value `develop` are used in the VIP-CLI command examples below. Read more about [how to target environments in VIP-CLI commands](https://docs.wpvip.com/vip-cli/target-environments/). ## Access **Prerequisite** To access the **Software Versions** panel, a user must have at minimum an [Org member role](https://docs.wpvip.com/manage-user-access/vip-dashboard/org-roles) or an [App write role](https://docs.wpvip.com/app-role/) for that application. To access the **Software Versions** panel: 1. Navigate to the [VIP Dashboard](https://dashboard.wpvip.com/) for an application. 2. Select an environment from the environment dropdown located at the upper left of the VIP Dashboard. 3. Select “**Code**” from the sidebar navigation at the left of the screen. 4. Select **“Software Versions”** from the submenu. ## WordPress Select a version of WordPress to deploy to an environment, or enable managed updates that will automatically update WordPress to the latest stable version. Available minor releases and security releases for the active version of WordPress are automatically applied to environments. ### Enable managed updates Enabling managed updates for an environment will automatically update the environment’s version of WordPress to the latest stable release according to VIP’s [platform release schedule](https://lobby.vip.wordpress.com/platform-release-schedule/). If managed updates are enabled for an environment that is not yet running the latest stable release version of WordPress, the environment will also be updated to the latest stable release version. * VIP Dashboard * VIP-CLI 1. Select the tab labeled “**WordPress**“. 2. Set the managed updates toggle switch to “on”. A visual indicator of a check mark( ✓) will appear in the toggle. 3. Select the “**Update**” button. 4. A dialog box will appear, prompting the user to confirm or cancel the update to the environment’s settings. Select the “**Confirm**” button to proceed with enabling managed updates for the environment. 5. An option will be given in a dialog box to proceed with the update to the environment’s settings or to cancel the request. Select the “**Update environment**” button to proceed with enabling managed updates for the environment. Configure the version of WordPress running on an environment to be automatically updated by the VIP Platform with the VIP-CLI command: ```wp-block-preformatted vip @. config software update wordpress managed_latest ``` In this command example, the version of WordPress on the `develop` environment of the `mytestsite` application will be set to `managed`: ```wp-block-preformatted vip @example-app.develop config software update wordpress managed_latest ``` ### Version selection Update the version of WordPress running on an environment to a selected version: * VIP Dashboard * VIP-CLI 1. Select the tab labeled “**WordPress**“. 2. Disable managed updates by setting the toggle switch to “off”. A visual indicator of an “x” mark will appear in the toggle. 3. Select the dropdown to display a list of available versions of WordPress. 4. * **Supported:** Minor WordPress version releases **X.X** (e.g. 6.3, 6.4) that are secure and stable. * **Testing: **“[Trunk](https://make.wordpress.org/core/handbook/contribute/svn/#what-is-svn)” version intended for testing development code on **non-production environments** in preparation for the next major release cycle of WordPress. * **Deprecated:** Versions of WordPress that no are no longer eligible for security updates and will soon be unavailable on the VIP Platform. 5. Select the “**Update**” button. 6. An option will be given in a dialog box to proceed with the update to the environment’s settings or to cancel the request. Select the “**Update environment**” button to proceed with the WordPress version update for the environment. Update the version of WordPress running on an environment with the VIP-CLI command: ```wp-block-preformatted vip @. config software update wordpress [version] ``` In this command example, the version of WordPress running on the `develop` environment of the `mytestsite` application will be updated to 6.3: ```wp-block-preformatted vip @example-app.develop config software update wordpress 6.3 ``` ## PHP Update the version of PHP running on an environment to a selected version: * VIP Dashboard * VIP-CLI Select the tab labeled “**PHP**“. Select a PHP version from the dropdown list.Select the “**Update**” button. An option will be given in a dialog box to proceed with the update to the environment’s settings or to cancel the request. Select the “** Update environment**” button to proceed with the PHP version update for the environment. Update the version of PHP running on an environment with the VIP-CLI command: ```wp-block-preformatted vip @. config software update php [version] ``` In this command example, the version of PHP running on the `develop` environment of the `mytestsite` application will be updated to 8.2: ```wp-block-preformatted vip @example-app.develop config software update php 8.2 ``` ## VIP MU plugins The [VIP Platform’s Must Use (“MU”) plugins](https://docs.wpvip.com/vip-go-mu-plugins/) are deployed to all VIP Platform WordPress applications. The VIP MU plugins [production branch](https://docs.wpvip.com/vip-go-mu-plugins/#0-vip-mu-plugins-production-branch) is intended for production environments, and the [staging branch](https://docs.wpvip.com/vip-go-mu-plugins/#h-vip-mu-plugins-staging-branch) is useful for testing upcoming features on non-production environments. Update the version of VIP MU plugins running on an environment to a selected branch: * VIP Dashboard * VIP-CLI 1. Select the tab labeled “**MU plugins**“. 2. Select a VIP MU plugin version (production branch or staging branch) from the dropdown list. 3. Select the “**Update**” button. 4. An option will be given in a dialog box to proceed with the update to the environment’s settings or to cancel the request. Select the “**Update environment**” button to proceed with the VIP MU plugins version update for the environment. Update the version of VIP MU plugins running on an environment with the VIP-CLI command: ```wp-block-preformatted vip @. config software update muplugins [version] ``` In this command example, the version of VIP MU plugins running on the `develop` environment of the `mytestsite` application will be updated to the staging branch: ```wp-block-preformatted vip @example-app.develop config software update muplugins staging ``` ## Node.js [Node.js Long Term Support (LTS) releases](https://nodejs.org/en/about/previous-releases) in Active or Maintenance status—as well as the next Active LTS candidate—are available for Node.js environments. Update the version of Node.js running on an environment to a selected version: * VIP Dashboard * VIP-CLI 1. Select a Node.js version from the dropdown list. 2. Select the “**Update**” button. 3. An option will be given in a dialog box to proceed with the update to the environment’s settings or to cancel the request. Select the “**Update environment**” button to proceed with the Node.js version update for the environment. Update the version of Node.js running on an environment with the VIP-CLI command: ```wp-block-preformatted vip @. config software update nodejs [version] ``` In this command example, the version of Node.js running on the `develop` environment of the `mytestsite` application will be updated to 22.0: ```wp-block-preformatted vip @example-app.develop config software update nodejs 22.0 ``` Last updated: November 07, 2024