AWS Developer Tools Blog

macOS support policy updates for the AWS CLI v2


Today, Amazon Web Services is announcing the official macOS version support policy for the AWS Command Line Interface (AWS CLI) v2.

On 2024-06-20, the AWS CLI v2 PKG installer and source distribution bundle will no longer support macOS versions 10.14 (Mojave) and prior. We may discontinue support sooner if it’s necessary to respond to an emergent security issue. Moving forward, the AWS CLI v2 will provide compatibility with macOS versions N, N-1, N-2, N-3, and N-4, where N is Apple’s latest major macOS version. After the AWS CLI team ends support for a specific version of macOS, compatibility with newer AWS CLI v2 versions will not be guaranteed.

For example, once Apple releases macOS 15, the AWS CLI v2 will end support for macOS 10.15 (Catalina). The following table shows the supported macOS versions under the new policy:

macOS Version Release N Version
OS X 10.9 (Mavericks) 2013-10-22 N-10
OS X 10.10 (Yosemite) 2014-10-16 N-9
OS X 10.11 (El Capitan) 2015-09-30 N-8
macOS 10.12 (Sierra) 2016-09-20 N-7
macOS 10.13 (High Sierra) 2017-09-25 N-6
macOS 10.14 (Mojave) 2018-09-24 N-5
macOS 10.15 (Catalina) 2019-10-07 N-4
macOS 11 (Big Sur) 2020-11-12 N-3
macOS 12 (Monterey) 2021-10-25 N-2
macOS 13 (Ventura) 2022-10-24 N-1
macOS 14 (Sonoma) 2023-09-26 N

Migrating to macOS 10.15 or later

For users currently on macOS 10.14 or prior, we encourage you to upgrade to macOS 10.15 or later to minimize the impact of future macOS deprecation campaigns. Customers using Amazon Elastic Compute Cloud (Amazon EC2) can upgrade using official AMIs for macOS 10.15, 11, 12, 13, and 14.

For users unable to upgrade to macOS 10.15 or later, we recommend installing a version of the AWS CLI v2 that supports macOS 10.14 or prior. For more information on installing past releases of the AWS CLI v2, please visit the installation docs.


If you’re currently using macOS 10.14 or prior, the AWS CLI team encourages you to upgrade to macOS 10.15 or later. Please share your questions, comments, and issues with us on GitHub.

About the author:

Steve Yoo

Steve Yoo

Steve is a Software Development Engineer on the AWS CLI team. You can find him on GitHub @hssyoo.