AWS SDK for Ruby: Deprecating Ruby 2.5 & 2.6 Runtime Supports and Future Compatibility

Effective June 2, 2025, AWS SDK for Ruby Version 3 will no longer support following end-of-life (EOL) Ruby runtime versions:

• Ruby 2.5 (EOL began on 2021-04-05)
• Ruby 2.6 (EOL began on 2022-04-12)

To ensure your applications and services remain secure, we strongly encourage you to upgrade to Ruby 2.7 or later.

Moving forward, AWS SDK for Ruby will proactively drop Ruby runtime versions 3 years after they have reached end-of-life. This approach ensures we provide up-to-date and secure libraries. Our deprecation strategy will follow from the official Ruby maintenance timeline, promoting a predictable and transparent support cycle for the SDK. It also lets us stay aligned with the AWS SDK and Tools maintenance policy for language runtimes.

If you’re not ready to upgrade

On June 2, 2025, AWS SDK for Ruby will require Ruby 2.7 as its minimum version. Each AWS service gem’s CHANGELOG.md file will detail a specific gem version where the support for the older runtime version is discontinued.

If you are using Ruby runtimes 2.6 or earlier and are not ready to upgrade to a newer version, the following options are available:

• If you are using Bundler to manage gem dependencies, ensure that the Bundler gem version is 1.13 or higher. Bundler will consider your Ruby version when downloading gem dependencies.
• If you are using gem install or any other method, you will need to use the information in the CHANGELOG.md file to manually pin specific gem versions.

If you encounter any issues or have questions, please create an issue or discussion on the AWS SDK for Ruby’s GitHub repository.

About the author: