How do I upgrade my Elastic Beanstalk environment platform from a deprecated or retired version?

Short description

You might receive an AWS Health notification that your Elastic Beanstalk platform branch is deprecated or marked for retirement. A deprecated platform branch continues to receive updates until its retirement date, but is no longer recommended for use. A retired platform branch no longer receives any updates.

There is a 90-day grace period from the published retirement date for existing customers with active environments that run on retired platform branches.

Important: An Elastic Beanstalk environment on a retired platform branch can end up in an unpredictable state. Elastic Beanstalk can't provide security updates, technical support, or hotfixes for retired platform branches.

Resolution

Note: The recommended update method varies by platform. Before you proceed, see Updating your Elastic Beanstalk environment's platform version to check the recommended method for your specific platform.

Apply minor or patch updates

With minor or patch changes, your platform branch remains the same. For example, you can update from PHP 8.2 AL2023 version 4.12.3 to PHP 8.2 AL2023 version 4.13.0.

Use one of the following methods:

Update your environment's platform version

For instructions, see Update your environment's platform version.

Configure managed platform updates

With managed platform updates, you configure your environment to automatically upgrade to the latest version during a scheduled maintenance window. You can apply patch version updates only, or both patch and minor version updates.

For more information, see Managed platform updates.

Apply major updates

With major updates, your platform branch changes. For example, you can update from Node.js 22 AL2023 version 6.11.2 to Node.js 24 AL2023 version 6.11.2.

When you switch platform branches or to a different major platform version, you must perform a blue/green deployment. You must also use blue/green deployments when you migrate from Amazon Linux 2 to Amazon Linux 2023.

A blue/green deployment creates a separate environment with the latest platform branch and version.

For instructions, see Perform a blue/green deployment.

For a detailed list of retiring platform branches, see Elastic Beanstalk platform versions scheduled for retirement.

Related information

Elastic Beanstalk platform support policy

Blue/green deployments with Elastic Beanstalk