This documentation is for Version 1 of the Amazon CLI only. For documentation related to Version 2 of the Amazon CLI, see the Version 2 User Guide.
Installing, Updating, and Uninstalling the Amazon CLI version 1 on Windows
You can install version 1 of the Amazon Command Line Interface (Amazon CLI) on Windows by using a standalone
installer (recommended) or pip
, which is a package manager for Python.
Don't include the prompt symbol (C:\>
) when you type a command. These are
included in program listings to differentiate commands that you type from output returned by
the Amazon CLI. The rest of this guide uses the generic prompt symbol ($
), except in
cases where a command is Windows-specific.
Topics
Install, update, and uninstall the Amazon CLI version 1 using the MSI installer
The Amazon CLI version 1 is supported on Windows XP or later. For Windows users, the MSI installation package offers a familiar and convenient way to install the Amazon CLI version 1 without installing any other prerequisites.
Install and update the Amazon CLI version 1 using the MSI installer
Check the Releases
-
Download the appropriate MSI installer:
-
Amazon CLI MSI installer for Windows (64-bit): https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi
-
Amazon CLI MSI installer for Windows (32-bit): https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi
-
Amazon CLI combined setup file for Windows: https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe
(includes both the 32-bit and 64-bit MSI installers, and automatically installs the correct version)
-
-
Run the downloaded MSI installer or the setup file.
-
Follow the on-screen instructions. By default, the Amazon CLI version 1 installs to
C:\Program Files\Amazon\AWSCLI
(64-bit version) orC:\Program Files (x86)\Amazon\AWSCLI
(32-bit version). -
To confirm the installation, use the
aws --version
command at a command prompt (open the Start menu and search forcmd
to start a command prompt).C:\>
aws --version
aws-cli/1.35.20 Python/3.11.6 Windows/10 botocore/1.18.6
If Windows is unable to find the program, you might need to close and reopen the command prompt to refresh the path, or add the installation directory to your PATH environment variable manually.
Uninstall the Amazon CLI version 1
To use the following uninstall instructions, you need to have installed the Amazon CLI version 1 with the MSI installer or setup file.
-
Open Programs and Features by doing one of the following:
-
Open the Control Panel, and then choose Programs and Features.
-
Open a command prompt and enter the following command.
C:\>
appwiz.cpl
-
-
Select the entry named Amazon Command Line Interface, and then choose Uninstall to launch the uninstaller.
-
Confirm that you want to uninstall the Amazon CLI.
-
(Optional) Remove the shared Amazon SDK and Amazon CLI settings information in the
.aws
folder.Warning
These configuration and credentials settings are shared across all Amazon SDKs and the Amazon CLI. If you remove this folder, they cannot be accessed by any Amazon SDKs that are still on your system.
The default location of the
.aws
folder differs between platforms, by default the folder is located in%UserProfile%\.aws
.$
rmdir
%UserProfile%\.aws
Install, update, and uninstall the Amazon CLI version 1 using Python and pip on Windows
The Python Software Foundation provides installers for Windows that include
pip
.
Prerequisites
You must have Python 3.8 or later installed. For installation instructions, see the
Downloading
Python
Install and update the Amazon CLI version 1 using pip
-
To Install the Amazon CLI version 1, use the
pip3
command (if you use Python version 3 or later) or thepip
command.For the latest version of the Amazon CLI, use the following command block:
C:\>
pip3 install awscli --upgrade --user
For a specific version of the Amazon CLI, append a less-than symbol
<
and the version number to the filename. For this example the filename for version1.16.312
would be<1.16.312
resulting in the following command:C:\>
pip3 install awscli<
1.16.312
--upgrade --user -
Verify that the Amazon CLI version 1 is installed correctly. If there is no response, see the Add the Amazon CLI version 1 executable to your command line path section.
C:\>
aws --version
aws-cli/1.35.20 Python/3.11.6 Windows/10 botocore/1.18.6
Uninstall the Amazon CLI version 1 using pip
-
If you installed the Amazon CLI version 1 using
pip
, you must also uninstall usingpip
.C:\>
pip uninstall awscli
If you are using version Python 2 or 3, you might need to use the
pip2
orpip3
command. Use theaws --version
command to determine the Python version associated with your installed Amazon CLI version 1.C:\>
pip3 uninstall awscli
You might need to restart your command prompt window or your computer to remove all files.
-
(Optional) Remove the shared Amazon SDK and Amazon CLI settings information in the
.aws
folder.Warning
These configuration and credentials settings are shared across all Amazon SDKs and the Amazon CLI. If you remove this folder, they cannot be accessed by any Amazon SDKs that are still on your system.
The default location of the
.aws
folder differs between platforms, by default the folder is located in%UserProfile%\.aws
.$
rmdir
%UserProfile%\.aws
Add the Amazon CLI version 1 executable to your command line path
After installing the Amazon CLI version 1 with pip
, add the aws
program
to your operating system's PATH
environment variable. With an MSI
installation, this should happen automatically. But if the aws
command
doesn't run after you install it, you might need to set it manually.
-
Use the
where
command to find theaws
file location. By default, thewhere
command shows where a specified program is found in the system'sPATH
.C:\>
where aws
The paths that show up depend on your platform and which method you used to install the Amazon CLI. Folder names that include version numbers can vary. These examples reflect the use of Python version 3.7. Replace the version with the version number you're using, as needed. Typical paths include the following:
-
Python 3 and
pip3
–C:\Program Files\Python37\Scripts\
-
Python 3 and
pip3
--user option on earlier versions of Windows –%USERPROFILE%\AppData\Local\Programs\Python\Python37\Scripts
-
Python 3 and
pip3
--user option on Windows 10 –%USERPROFILE%\AppData\Roaming\Python\Python37\Scripts
-
MSI installer (64-bit) –
C:\Program Files\Amazon\AWSCLI\bin
-
MSI installer (32-bit) –
C:\Program Files (x86)\Amazon\AWSCLI\bin
Use the following steps based on whether a file path is returned.
-
-
Press the Windows key and enter
environment variables
. -
Choose Edit environment variables for your account.
-
Choose PATH, and then choose Edit.
-
Add the path you found into the Variable value field, for example,
.C:\Program Files\Amazon\AWSCLI\bin\aws.exe
-
Choose OK twice to apply the new settings.
-
Close any running command prompts and reopen the command prompt window.
Troubleshooting Amazon CLI install and uninstall errors
If you come across issues after installing or uninstalling the Amazon CLI, see Troubleshooting errors for the Amazon CLI for troubleshooting steps. For the most relevant troubleshooting steps, see Command not found errors, The "aws --version" command returns a different version than you installed, and The "aws --version" command returns a version after uninstalling the Amazon CLI.