How to upgrade the AWS CLI to the latest version

Upgrading your AWS CLI V2 to the latest version is a crucial part of maintaining your AWS environment. An updated AWS CLI ensures optimal performance, access to new features, and better security.

This guide will walk you through the process of upgrading your AWS CLI to the latest version, without using Python pip for the installation and update.

Check the Installed AWS CLI Version

Before we begin with the upgrade process, it’s essential to check the currently installed AWS CLI version on your machine. Currently AWS actively maintains two versions of the AWS CLI, which is Version 1 and Version 2.

On the long term version 1 will be deprecated, so it’s recommended to start using version 2. You can check which version you are currently running by using the following command in your terminal:

aws --version

This will return the current AWS CLI version installed on your machine, along with some additional information such as the Python version and the operating system.

➜ aws --version
aws-cli/2.11.1 Python/3.11.4 Darwin/22.5.0 source/x86_64 prompt/off

Note: If you haven’t installed the AWS CLI v2 yet and you’re a Linux or Windows user. Then you can do this by visiting the official AWS CLI user guide and install the appropriate version for your operating system.

For MacOS users I would recommend to install the AWS CLI v2 via homebrew.

Install the Latest AWS CLI Version

1. Update the AWS CLI v2 version on Linux

To install the latest version of AWS CLI v2 on Linux you need to download the official installer and the run the following command to update the executable on your machine.

# Download 64 bit linux installer
curl "" -o ""

# Or download ARM linux installer
curl "" -o ""

# Next unzip the contents and update your awscliv2 version
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update

The --upgrade flag ensures that the installer updates the current executable and installation dir with the newly updated files. Note: make sure to use the correct --bin-dir and --install-dir location.

2. Update the AWS CLI v2 version on MacOS

To install the latest version of AWS CLI v2 on MacOS you can make use of Homebrew to easily update the awscli on your machine via a simple command:

➜ brew upgrade awscli

==> Fetching awscli
==> Downloading
Already downloaded: /Users/dsteenman/Library/Caches/Homebrew/downloads/32200fd8ea1a8ded93dbf2f0413ea2e272e8f245d1ded3507f8904bf2772d53b--awscli-2.13.5.bottle_manifest.json
==> Downloading
Already downloaded: /Users/dsteenman/Library/Caches/Homebrew/downloads/09caa67e5e61cabc71e05bdb090e024fbd01d5194f13e5cda54903c0949bbeb2--awscli--2.13.5.ventura.bottle.tar.gz
==> Pouring awscli--2.13.5.ventura.bottle.tar.gz
==> Caveats
The "examples" directory has been installed to:

zsh completions and functions have been installed to:
==> Summary
🍺  /usr/local/Cellar/awscli/2.13.5: 13,649 files, 119.9MB
==> Running `brew cleanup awscli`...
Disable this behaviour by setting HOMEBREW_NO_INSTALL_CLEANUP.
Hide these hints with HOMEBREW_NO_ENV_HINTS (see `man brew`).

3. Update the AWS CLI v2 version on Windows

To update your current installation of AWS CLI on Windows, download a new installer each time you update to overwrite previous versions.

The official AWS CLI MSI installer for Windows can be downloaded from here:

Verify the newly updated version

After successfully installing the latest AWS CLI version, you should verify the installation.

You can do this by checking the installed AWS CLI version. Run the aws --version command again:

➜ aws --version
aws-cli/2.13.5 Python/3.11.4 Darwin/22.5.0 source/x86_64 prompt/off

The version displayed should be the new version you just installed.

Troubleshooting common issues

Upgrading the AWS CLI should typically be a smooth process, but you might encounter some issues.

If the installation fails or the new version doesn’t show up after installation, ensure that the AWS CLI binaries are in your PATH environment variable.


Upgrading the AWS CLI to the latest version involves checking your current version, downloading the installer package and using that to update the current installation executable on your system.

It’s a good practice to keep your AWS CLI updated to the latest version to leverage the newest features, bug fixes, and security patches.

With the steps provided in this guide, you can now easily upgrade your AWS CLI.

Danny Steenman

A Senior AWS Cloud Engineer with over 9 years of experience migrating workloads from on-premises to AWS Cloud.

I have helped companies of all sizes shape their cloud adoption strategies, optimizing operational efficiency, reducing costs, and improving organizational agility.

Connect with me today to discuss your cloud aspirations, and let’s work together to transform your business by leveraging the power of AWS Cloud.

I need help with..
stacked cubes
Improving or managing my CDK App.Maximize the potential of your AWS CDK app by leveraging the expertise of a seasoned CDK professional.
Reducing AWS Costs.We can start by doing a thorough assessment of your current AWS infrastructure, identifying areas with potential for cost reduction and efficiency improvement.
Verifying if my infrastructure is reliable and efficient.We’ve created a comprehensive AWS Operations Checklist that you can utilize to quickly verify if your AWS Resources are set up reliably and efficiently.