AWS Developer Tools Blog

CLI v1 Maintenance Mode Announcement

In alignment with our SDKs and Tools Maintenance Policy, version 1 of the AWS Command Line Interface (AWS CLI v1) will enter maintenance mode on July 15, 2026 and reach end-of-support on July 15, 2027.

Scripts and workflows made for AWS CLI v1 will continue working during this period, unless an AWS service makes fundamental changes. Such large changes are uncommon, and we will communicate them broadly. Between July 15, 2026 and end-of-support on July 15, 2027, AWS CLI v1 will only receive critical bug fixes and security updates. We will not add new features to the AWS CLI v1, including changes to AWS CLI v1 itself, new AWS services, existing services, or expansions of regions and endpoints.

The following table outlines the level of support for each phase of the SDK lifecycle.

SDK Lifecycle Phase Start Date End Date Support Level
General Availability 11/19/2015 7/14/2026 During this phase, AWS CLI v1 is fully supported. AWS will provide regular releases that include support for new services, API updates for existing services, as well as bug and security fixes.
Maintenance mode 7/15/2026 7/14/2027 AWS will limit releases to address critical bug fixes and security issues only. The AWS CLI v1 will not receive API updates for new or existing services, or be updated to support new regions.
End-of-support 7/15/2027 N/A AWS CLI v1 will no longer receive updates or releases. Previously published releases will continue to be available via public package managers and the code will remain on GitHub.

We recommend that customers of AWS CLI v1 migrate to AWS CLI v2. The AWS CLI v2 provides improved features, enhanced performance, and continued support from AWS. By adopting the latest version of the AWS CLI, developers ensure the security, compatibility, and stability of their solutions on AWS. Updating enables you to leverage the latest services and innovations from AWS. To learn more, refer to the following resources:

  • The AWS CLI landing page contains links to the getting started guide, key features, examples, and links to additional resources.
  • The Migration guide for the AWS CLI version 2 in the AWS CLI User Guide explains the changes between the two versions and instructions for migrating.
  • You can use CLI v1’s upgrade debug mode introduced in 1.44.0 to highlight features that have changed from v1 to v2 when executing your commands or scripts, as well as the AWS CLI v1-to-v2 Migration Tool to lint and upgrade scripts.
  • The AWS CLI Version 2 – General Availability announcement post in the AWS Developer Tools Blog outlines the motivation for launching AWS CLI v2 and includes the benefits over AWS CLI v1.

Additional features of AWS CLI v2

The AWS CLI v2 includes an embedded version of Python and no longer requires, or interacts with, your system-wide version of Python. A major theme for version 2 is the interactive features such as server-side command completion, auto-prompt, and wizards that guide you through constructing and running AWS CLI commands. V2 also supports simplified developer access with aws login,  AWS IAM Identify Center authentication, and new commands under aws configure for managing profiles and credentials.

While we strived to keep the two versions of AWS CLI compatible, there are features introduced in version 2 that have not been back ported to version 1. The most notable are high-level DynamoDB commands, EC2 Instance Connect with an SSH client, and the interactive mode for CloudWatch Logs Live Tail.

Feedback

If you need migration assistance or have feedback, reach out to your usual AWS support contacts. You can also open a discussion or issue on GitHub. Thank you for using the AWS CLI!


About the authors

Anna-Karin Salander

Anna-Karin Salander

After a career in networking and software development, primarily with Java, Anna-Karin is now a manager for the AWS CLI and AWS SDK for Python.